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CodeWarnor is the only serious choice 
for professional Mac^ development. 

Chances arc, evciy Mac program you 
use was created using CodeWarrior. In 
laci, more than 90% of all commercial 
Mac OS appliaUions are buik with 
CodeWarrior. 

Built with the Mac developer in mind. 
The CodeWarrior Inicgralcd Devebp- 
ment Environment (IDE) has won every 
major award given u> Mac development 
software. lEs the worldwide standard for 
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creating Mac software, and continues to 

lead the industry. 

Check out these CodeWarrior benefits: 

i/ The Slate -of-Lhe-art IDE 
your Jevebpmenf (one 

4 / Evffrrhing you need m one ho^.*. 
project manager, editor, compilers, 
debuggers, linkers, assemblers, 
profilers, a file compare uiiliiy, our 
world-class framework Pow'erPlani^ 
and the flexibility to plug-in third 
pany components. 

s/ Use file .some fomUior fon/sef 
to develop for all the major 
platforms, including Windows^ 
Linux, Solans ; game consoles 
and embedded platforms. 

Tightest ISO/IEC C++ siriiubrcls 
fompliflnre, 

C, C++ rind Java "' support 
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Imetrowerks 


CodeWarrior 

for Mac OS 


Go with the world-class standard 

Use the same powerful, [lexiblc, 
fast toolset that built world<lass 
apps like Adobe‘s Photoshop'^ and 
Neisca|:)e‘ Navigator? 


See for yourself. 

Don’t just take our word for it. 

Get your FREE* 30-day evaluation 
edition of CodeWarnor for Mac OS 
and put H 10 the test. 



I Discover why over 
1 ZOO,000 programmers 
I worldwide use CodeWarrior. 

Call today or order online 
FREE 30‘day evaluation 

«vwiM.inBtraiMeriis.coin/ 9 o/iiictac<i 

1-800-377-5416 

'Mrm-fflt^irrrtahlR silipprng and hafidimg of SI .95 
per CD applies, plus state sales tax if applicable. 


Hiirry! This ofler expires 4/30/2000. 




© 1999-?000 MoTrowBfka All nurtfs reserved MetrowerKs. Bie Metrowsrks logo and CodeWarTkir are rcijjsrcred trademarks, and i^owsrflarrt is a trarJemarii cri Metrmivetks tnc:. All olliar pmduUs are Irademarlis of Ibeir 
respeUitve mmiunies. Alf uriecs are in US dollars: otfer good in US and Canada only. GtNfeWaninr for Mac OS. Prulcssloiial Edition, targets Mac OS and WindOiArs StS'SS/NI only, oWiflr tarpits availahle s^par^ety 



































*^Wiihoui a doubly the Premiere Resource Editor 
for the Mac OS A wealth of time-saving tools,** 

- MacUser Magazine Eddy Awards 

"A distinct improvemen t over Apple's ResEdit ." 

- MacTech Magazine 

**Every Mae OS developer should own a copy of Resorcerer” 

— Leonard Rosenthof Aladdin Systems 

""Without Resorcerer, our localization efforts would look like a ^ 

Tower of Babel, Don't do product without it!” 

- Greg Galanos, CEO and President, Metrowerks 

""Resorcerer's data template system is amazing, ” 

— Bill Gotximan, author of Smaller Installer and Compact Pro 

“Resorcerer Rocks! Buy it, you will NOT regret it” 

- Joe ZobkiWj author of A Fragment of Your Imagination 

“Resorcerer will pay for itself many times over in saved time and effort," 
— MacUser review 

""The template that disassembles "PICT^s is awesoFue!” A 

— Bill Steinberg, author of Pyro! and PBlhols 

“Resarcerer proved indispensible in its own creationr 

- Doug McKenna, author of Resorcerer 
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Version 2.0 



• Very fast, HFS browser for viewing file tree of all volumes 

• Extensibility for new Itesorcercr Apprentices (CFM plug-ins) 

• New AppleScript Dictionary Caete’) Apprentice Editor 

• MacOS 8 Appearance Manager-sawy Control Editor 

• PowerPlant text traits and menu command support 

• Complete AIFF sound file disassembly template 

• Big-, little-f and even mixed-endian template parsing 

• Auto-baekup during file saves; folder attribute editing 

• Ships with PowerPC native, fat, and 68K versions 



Requires System 7.0 or greater, 
L5MB RAM, CD-ROM 


Standard price: $256 (decimal) 
Website price: $128 - $256 
(Educational, quantity, or 
other discounts available) 


Fully supported; it's easier, faster, and more productive than ResEdit 
Safer memory-based, not disk-file-based, design and operation 
All file information and common commands in one easy-to-use window 
Compares resource files, and even edits your data forks as well 
Visible, accumulating, editable scrap 

Searches and ope ns/m arks/selects resources by text content 
Makes global resource ID or type changes easily and safely 
Builds resource files from simple Rez-like scripts 
Most editors DeRez directly to the clipboard 

All graphic editors support screen-copying or partial screen-copying 


Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 


Payment: Check, PO's, or Visa/MC 
Taxes: Colorado customers only 


Extras (call, fax, or email us): 
COD, FedEx, Ure Blue/Red, 


All graphic editors support screen-copying or partial screen-copying 
Hot-linking Value Converter for editing 32 bits in a dozen formats 
Its own 32-bit List Mgr can open and edit very large data structures 
Templates can pre- and post-process any arbitrary data structure 
Includes nearly 200 templates for common system resources 
TMPLs for Installer, MacApp, QT, Balloons, AppleEvent, GX, etc. 
Full integrated support for editing color dialogs and menus 
Try out balloons, Hetb’s, lists and popups, even create C source code 
Integrated single-window Hex/Code Editor, with patching, searching 
Editors for cursors, versions, pictures, bundles, and lots more 
Relied on by thousands of Macintosh developers around the world 


International Shipping 


MATHEMi^ESTHETICS, INC. 

PO Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440-0707 
Fax: (303) 440-0504 
resorcerer^mathemacsthetics.com 


Tb order by credit card^ or to get the latest news, bug fixes, updates, and apprentice's, visit our website^. 


www.mathemaesthetics.com 
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VIEWPOINT 


By Jordan Dea-Mcillson 


Apple's best kept sh^tiet,*. 
ll isii'l AppIcScriptl 

I*or many yeai^, Apple’s best kept secret was AppleScript. 
An incredibly powerllil feature of Mac OS that was, when it was 
marketed at all, marketed by stealth. But now the mantel of‘*best 
kef>t secret” lias lieen passed and the focus t>f Apple’s stealth 
marketing activiiies has shifted to a new pnxluct. 

Ani> toe winner is,,, 

WebObjecls! Yes, tliat's right. The tHurent ftKUS of Apple’s 
siealih marketing activities is WebObjecLs, a well application 
seiner ftjr Windows H\\ Solaris, 1 iP/UX, and Mac OS X Server. 

Originally devclo[ied by NeXT in the early 90s and Irased 
on many of the s;tme technologies dial underlay Apple’s Mac OS 
X and CcK’oa, WeliObjects is the oldest and most maaire 
application server on the market. Before there was NeLscape 
Application Server, Visual InierDev, SilverStream, llAirisite, or 
'larigo. there was WehObjeets. 

Now on version 4.5, WeliOhjects’ maturity shows in the 
cleanliness and quality of its architecture, as well as in the 
peribrmance, scalability, and reliability it delivers. 

The Performance Ieader 

When building w'elvliased a[)plicaiions responsiveness and 
performaiK’e are crittrah As Jakob Nielsen reminds us again and 
again in his Alertlkix W'cb columns (see Links of Interest below 
for the DldJ, the Itniger that people have to wait for a page to 
lie delivered, the greater the chance that thL 7 will dxiil out” and 
you will lose a customer. 

As Nielsens is fond of obsening in his writings, in most 
non-Web sellings, if someone has waited more than 10 seconcLs 
without a resjxnisc\ they will bail our and go somewJiere else. 
Unfommately, cveb users are use to c|utLe a bit of abuse in the 
form of unresptriisive systems, and they will usually w^att 15 
sectmds before f>ailing out. 

What does this mean for you? Well, on the negative side, it 
[ueans that for the Ix^st user interaction and acceptant:e you need 
K) get your [>age up there in 10 sect)nds or less. On the jxxsitive 
side, the faster you gel your page displayed, the more you will 
stand out from the crowd. And as many sites have learned, 
strong and positive word of mouth often trumps milikms 
missfxmt on stupid SujktBowI ads. 

On the peiformance front, WeltObjects wins heads clown, 
tn a study tx.mchmarking the performance of a number of 
commercial a[>plicatio!t servers - including Netsctipe Application 
Server, flAHlsite, Silverstrcam, Visual InterDev, Powerj 
nnlcTfrrise, Tang(], and, of tx>urse, WeliObjecUs - conducted by 


tile rcsearc'li firm TechMetrix Research, WcitObjects Ixut die 
competition acrcKs die Ixiard. 

Pretty much across the board, WefjObjecis l>eat its nearest 
coiiipetitors by a factor of 4, and always delivered - even under 
the heaviest krads - die sufvK) seconci responsiveness tliai 
tiisromers demand. 

But don’t believe me; check out the data for yourself. Go 
to the TecluMeirix Research web site and check out llie 
Application Seri^er Performance Results for 1 to 10 simultaneous 
users and for 25 to 250 simultaneous users (see links of Interest 
below for the URLs). 

Scale Baby, Sc^e! 

Hand-in-hand with perfonrutnee, scalability is of atual 
importance to the success of any mission critical web site. IT your 
system canT eiisily scale from 100 liits an hour to 10 million hits 
an hour, Uien yon are setting yourself up for a whole lot of 
hulling in tlie future. 

First, as the TediMetri.x performanc'c benchmarks we 
di.sais,sed alxive show, WebObjects nicely scales when servicing 
from 1 to 250 highly dt‘m:mding simultaneous users. On there 
own, these Ixnchmarks are excellent. But they really standout, 
w'hen we compare them to tlie oilier application servers in 
TecliMcirix’s study. When com[Xired side-by-sidc, it is clear dial 
WeK.)bjects liandily blows aw'ay the competition not just in 
performance, but also in scalability. 

So, WeiiObjecis scales well when running on a single 
machine. But how does it juTform when you need to distribute 
your load over lOs or even UH)s of systems? How easy ts it to 
build a mission cTitical web appliaition that can easily l)e 
disiril>uied across multiple Jiiaclilnes? 

The short aaswer is quite ea.sily. The long answ'er. Is that 
WebObfecLs - like the a^sf of the frameworks, including Ctx:oa, 
originully developed by NeXT - is based r>n a distrihuteti objects 
(1)0) layer. This layer allows you to easily take a WebObjects 
ajJplicaLion and scale it from 1 to 2 to K) to KX) servers, allowing 
you to grow y(3ur infrastniciiire to meet customer ilemand. 

Always reliable 

I low many timers have you found a web sice or wcl) 
application that intrigued you, but when you tried to use it didn’t 
work or broke down at some critical fKiint? And how c|uic kly did 
you walk away from tliat web .site? The lesson learned here is, it 
doesn’t matter how feature' packed and interesting* or fast your 
web application Is, or how well it scales* if it doesn’t nm 
smtxHhIy anti reliably^ cu.stomers will dump you and go 
somewhea" else in a New York minute. 

Continued on page 33 
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MacHASP USB Key! 


Question: Is MacHASP USB* a 
software security key or a 
sales tool? 

Answer: It's both! 

MacHASP USB Is the world's first 
software protection key for the 
iMac. It gives you sophisticated 
license enforcement and compre¬ 
hensive protection against illegal 
use... in other words, real security. 

Then it gives you a big selling 
advantage. 

With MacHASP USB, you can 
license multiple software modules 
and applications. You can instantly 
unlock or upgrade them in the 
field. Plus you can freely distribute 
demos. 

Bottom line: MacHASP USB locks 
out illegal users and unlocks your 


full sales potential - without 
getting in anyone's way. Call now 
to request a Developer’s Kit and 
our newly published guide to USB 
features and benefits. 

*For all USB-equipped Macs running an OS 
with USB support. Fully compatibio with the 
AOB version of MacHASP. 

AcctlcRiiE]:j^ 

MacOS 

USA: 1-800-223-4277 
212-564-5678 
Int’l: 972-3-6362222 

www.aks. com/mt 

ALADDIN 

KNOWLEDGE SYSTEMS LTD 


Mac software protection provider, Micro Macro Technoiogies, becomes part 
of Aiaddin, giving its customers even better service from the number one name. 


GETTiniC 

STARTED 


By Dan Parks Sy^ow 


Opening a Picture File 


How a program opens a 
picture file and displays 
that filers contents in a 
window 


In bi St in o n til CJetfi ng Slariad a rt I cl e 
we examined the details of flow a 
program opens an existing text Hie, 
as?>(K:iates that filers text willi a window, 
and then displays tlie text in ifnii 
window- Doing tliis involves locating the 
file to open on disk, opening the file, 
reading the file’s text to memory, 
maintaining a liantlle ro the text in 
memory, and then hitiding that handle to 
a window. I'hat same article stated that 
many of these lechniqiies are ap[>liLal>le 
to files that hold data other than text, 
Tliis month, we prove our case hy 
suhstituting "picture’" for "‘text.” Last 
month you saw how' your Mac program 
can create windows that keep track of 
text, fiere you read the details of how 
your Mac program i*an create windows 
that keep track of gruiihics. 


The field or fields of the data slnicftire can l>e of types of 
your chtK)sing, For instance, we could just as easily define the 
WincJData staicturc as a structure that ht>lds a handle to a picture 
rather than a handle to ediialile text: 

typedijf struct 
t 

Pidlandlc vfiudPict i 

I WindData. *WfndDataPLrH '^WindDataHandle: 

A new staiaure of this data type is easily created with a c^ll 
to NewHandleClear(). 

WindnataBandle theData: 

Liitjlbta - (WindDataHand Ic] NcwfluTidieCIeart sizeof(Windflata) }; 

Next, a window is npenetl. llien llie application-defined 
data smuiure Is assiKiatetl with ihe nvw^ window !>y storing a 
hutidle to tfie data siaicture in the window’s refCon field: 

WindrjwPr r itiE?Wlfidow: 

theWinduw ^ CctNevWindowt I2S, nlL (WiiidovPtr)-IL ): 

SetWRctConC theWindow. floTig)iheData ): 

Al this fxiint we’ve creiitcd an empty' cktta stiucture and 
asscxtiled it witli a window. Next we need to (jjK'n an existing text 
fik*. A caW to the Ttxilijox fundion StandardGetFilePreviewtHi*^ 
the siamiani open file dialog fx)x for the user. 


WiNDOw^s AND Fm; Dai'a Review' 
liist month in Ckiling Siarjed you 
read alxnit a scheme for associuling a filers 
contents with a specific window'. Tliere wc 
employed the use of an application- 
defined document record data type: 

typedef stmct 
t 

TEHandie windT^j^t: 

I WindData, *WlndDataFtr* 

* ’WindDu r.nHund le: 


SFTypcLl^it typeLlat = ( ^PTGT\ 0. 0, 0 I: 

StaiidatdFlleReply reply: 

Sta£:dardGetFilePrRVIew( all* 1* typeLlst. fcreply ); 

rhe first argument can Ix" a pointer to a niter fundion that 
assisis in determining which fife lypes should lie displayexJ in the 
ofxm dialog box file list. A value of nil is used if no such 
a ppl id I ion-defined routine exists, 'I'he second argument to 
StandardGetFilePfeviewO pas.ses the numlier of file iy|Ks to Ix^ 
dLsplayecL Pass I if your j^iogram only works with one file tytie. 
71ie third aiguitieni is of type SFTypeList. The SFTypeList variable 
is a list that specifies ilie four-character file type (surroLinded in 
single ijijotes) of each of tlie typers of files your prognim can 
work witli. Fill the list w'ith four values, using a 0 for e^ich unused 
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file type, liist monlh’s example worked wiih text files, so then 
we used TEXT as the one non-zero element in the SFTypeUst, 
"Fliis month we'll Ixt working; with pkture files, so instead use 
‘Pier in this list. Hie last argument should he a pointer to a 
variable of lyjie StandardFileReply. Wlieii the user dismisses the 
optm dialog Ixix, the memljers of this stmeture varial)le will get 
filled information (such as him the dialog Ixjx was dismisstxl 
and tfie disk loeaiion of the selected llte (if the dialog lx>x wasn’t 
dismissed l>y a dick on the Cancel button). 

ir the user dismissed the dialog lx>x by t licking the Opoil 
button Cor by doul)le-clicking on a file name in the dialog Ixjx 
iile list), the sfGood field of the StandardFileReply variable will 
iuive a value of true and the program can prex eed lo open the 
selected file. That's accomplished by calling FSpOpenDFO: 

short tileUerNiim r 

FSpOpeiiDF( treply.ijIKili', fjjRdPerm. &fil(!KefNurH ): 

Tfie first argument to FSpOpenDFQ is the file system 
specifiaition for the selected file. FSpOpenDF{) opens this file's 
data fi>rk, using the jXfrmissif>n level specified in the second 
argument (with fsRdPerm re[>resenting reatl-finly permission). 
After opening the file, FSpOpenDF() returns a file reference 
numlXT. Tlii.s nyml)er is then irstxl by your program to reference 
I he now i j|xn file. 


Rrinching a Fnx’s Ptctiire Into Memory 

After a picaire file Is open, your program needs to Isring 
most of the file’s data into memory. Note the word “most” in the 
previous sentence. Any file of type 'PICT has a 512-byte header 
that can be used as the file-crt-aling application sees fit. That 
means tills first half K of data is always unrelated to the data that 
comprises the pitaure iLself List month we used the Im^llxjx 
function GelEOF() to get a text file’s size in bytes. Here we use 
the same Rinaion to get a picture file’s size in bytes. The 
fileRefNum variable is die file inference number [)revicnisly 
returned to tfie program by a c:ili to FSpOpenDF(). 

lonR tileLcngiti; 

GftfEOFt fileRemuai, i f i 1 *^I.cngth ); 

SetFPosO is now cal let! to move the file mark—die position 
marker used to keep track of the current positiiin to read from 
or write lo—512 bytes into the file. The fsFromStart constani tells 
SetFPosO h> Ixfgin its byte count at the start of the file, while the 
512 value tells the function to ctxint that many bytes into die file. 

SetFPost flleHtjfNura. ffiFroaStart, M2 J; 

Now we need to create a memory buffer in which the 
cuntents of die selected file will lie read to. 'lb accomplish 
this for a text file we jumped right in with a call to NewPtr(). 
For a picture file we need to first make an adjustment to 
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ufcount for the hci iliut wcVc reading in less tlian the entire 
file (we’re skipping the header porticm). After that we create 
a new handle mther tlian a pcjinter Recall dial text that is lo 
he made editable is read into a buffer referenced by a pointer, 
and then that pointer is used in a call to TESetText() to copy 
the text to memory referenced by a hantlle. A picture is read 
into memory referenced by a handle, and no similar kind of 
manipulation is needed. 

Size plcLSlze; 

Hsndtf^ plcLureBuffer ^ 

plctSUe = fileLength - 512; 

pictureBuffer = Mf?wHnndli^Clt?ar C pittSizf^ 1; 

At tliLS ptrini we have an area set aside in memory. Tliai 
area is the size in bytes of the picture data in a pitiure hie, and 
the memory area is reterenced by a handle. Jt’s now time to read 
the file's conicnLs, storing the file data in the blfx-'k of memor>^ 
referenced by the ptetureBuffer handle* Ikaause FSRead() 
ex[)ects a pointer to a menKJiy hi i Tier, we need to dereference 
the handle one time Cto get to die |X)inter that the handle 
references). 

CSKeadt fileRefNnm* ^pictSSze. 'pictujpBuffer ); 

'Itie call to FSRead() reads in the [)icLiire cLata, and that data 
is referenced by a generic handle named piety re Buffer, However, 
it will Ik^ as a PicHandle in the application-dellned window data 
structure that we store ihe relea'nce to the [licture, so we v^int 
to convert this generic handlt^ to the more specific PicHandle. A 
siinjde type cast does the nick* 

PicHandIc pictureBandie: 

piciureHandie = ( PirH.mdli/ JpictnreBuff&r; 

At this point the firogram has a PicHandle ihat ii can use as 
it might any other picture handle, for instance, a call to 
DrawPictureO could lx* imde to dniw the picture to a window' 
(assuming a dc^stinaiion rectangle is sei up and a window Is 
o[K‘n and its port is set), Alternaiively. this PicHandle could Iv 
.stored in the windPicl held of an applicaritm-dehiied WindData 
window document recortl. 

ASMXaATIlVG A Fiufs CONTFNTS WlTlI A WINDOW 

With a file's pic ture that has Ixen t'opitxl to memoiy we 
need to associate tliut j>icture with one w indow—just ns we did 
last luonih with u file's text that was copied to memor>'. With the 
picture data stored in memor>^ and a PicHandle referendng that 
memory, wete just about there* Our application-defined 
WindData structure defines a single held—the windPicl held of 
type PicHandle. Earlier you s^iw how to create a new, empty 
WindData .structure and how^ to use a window's refCon field to 
asscKiate that structure with the window^: 

fc/indDaLallafidle theData; 
t^ltrdowl'tr theWindaw; 

theData “ (Vindt)at^lfutjdl 0 )NeuHaBdleClf^ar ( siz&of(WindData) ); 


thaWindav “ GeiKewWindow{ 128 . nil. (VindovPtr)-IL >: 
SeftfBefCont theWindov, (lang)theData 

To create a tie between the handle that references the 
file's contenis in memory (pictufeHandle) and the handle that 
ts a pan of the application-defined data strmture in memory 
(WindPicl), we dereference the data structure handle twice to 
allow access to the structure niember wrndPict. Ttie windPicl 
iTicmlxfr is of type PicHandle, as is tlie pictureHandle variable 
— so one variable value can be assigned to the other 
variable. After the following line of code executes windPict 
references the .same block of memory as pictureHandle* 

(* •theData) .wirtdPlcL - pictureHandle; 

When our program needs Ui access a window’s 
atldiiional data (here, a pitture — but we could have plenty 
of other data in our WindData data structure sucli as more 
than one j>icture and text) it now' has a simple means of 
doing so. From the use of SetWRefCon(), a window’s refCon 
field holds a reference to die as.soi’iated data structure — a 
call to GetWRefCon retrieves the reference: 

long wlndRcICon; 

vindRetCmi “ GetWRefCon( thoWlndow ): 

Here the variable windRefCon holds a value that is a handle 
to tlie window's WindData .structure* The refCon field is of type 
long, wdiiie WindData is of our application-defined type 
WindDafaHandle. A lypet^ast makes the projK-r conversion: 

thiBata ^ (WitidllaiiillaricLlelviiidKefCcFn; 

'lb access tlx* Held of^ tlic WindData structure we double- 
tlereference tlie handle that references the sinKiure fhen the 
value in the structure's field can be assignee] to a Icxal variable 
and Lised as the program sees fit. 

PicHandle pictureHandle; 
pictureHandle = .vlndPict: 

'fhe primaiy use a program has for a PicHandle is in 
drawing the picture the handle references. The Ixmnding 
rectangle nf tlie picture is held in die picFrame field of the 
picture stmeture that tlie PicHandle references. We ran extract 
tile wadth anti height of the picture from this Ixxinding rcdangle: 

Rflct pk’LRect; 

^hnrt plctWidtS: 
slion pictHelght; 

pictRect “ (•'‘picTurcJltjridle) .plcFtame: 
pictWidth ^ pictHect*right - pictRect*left: 
pictHfilght picLRect* bottom * piotRecl.top: 

Fn;iii die pittiire dimensions we cun then do somediing 
such a.s resize the a.s.s(K'iated window to match the size of die 
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picture (assurnirijj we want tlic picture to be tlie oniy thing 
displayed in the window). 

SlzeWindowE theWindnw, pictWidth, pictHeighl, false ); 

And, of course we can offset the picture Vs rectangle so that 
die drawing of the |>icture starts in the uppcTdeft t:omer of the 
window, and tlien draw the [)iclufe to the window: 

SetRect( ipiclRect^ 0^ 0* pierWidth, pictleight )j 
DrawPicture( pictureHandlE. Splctfiect ); 


OpenPictureFile 

This rru>nih'N program is OpenPiciitreTile. When you run 
OpenPictureFile you'll be presented with the dialog box 
pictured in Figure 1. 



When you select a picture file and click ihe Open button 
(or doublcHrlick on the file name in tlie list), the open Hie dialog 
Ik)X is tiismissed and a new window^ holding the contents of ilic 
sciecied picture file appettrs — as shown in Figure 3- 



Figure S Tfce O/mtPictnreHie program diKplaying ihe 
conietds of a picture Jtie. 

Notice that the window is sized to match the size of the 
picture — the program handles resizing of the window. When 
finished, click tlie mouse button to end the program. 


Figure L The 0}xmiictureFiie diahjg box with the prer^iw 
sect km expictided. 

When you click on a picturu file in the dialog Ixjx file list 
(move to any drive and folder to find a suitable type ‘PICT file) 
you’ll see a thumlmail image of that file's picture displayed 
under the Preview heading at the left side of the ofx'n file dialog 
Itox — as shown in Figure 2. Even though the file is a picture, 
the dialog box will place a small QuickTime-siyle cx)ntrQl under 
the preview image. If you uncheck the Show Preview 
checkix>x the dialog Itox will collapse and the preview 
information will dtsajijxjar (see Figure 3 ). 


Creating the OpenPictitreFile Risources 
B egin your development ijf the OpenPictureFile project 
by creating a new folder named OpenPictureFile in your main 
Code Warrior folder. Stan up ResFdit and create a new 
resource file named OpenPictureFile.rsrc. Specify that the 
OpenPictureFile folder serve as the resource file's destination. 
The OpenPictureFile. rsrc file will hold three resources—two 
of which you’ve created in previous examples. Together, 
ALRT 128 and DITL 128 define the program's error-ha [idling 
atcTL, If the OpenPictyreFile program runs into a serious 
problem while executing, then this alert appears and the 
program terminates. Figure 4 shows the three types of 
restJurces that this projeci rec|iures. 


[ CS 2000.05.PictureFile ▼ | 


CDiaz 2GB 

OpenPictureFile Data 

A. 

Eject I 

d ParrotPia 
@ TaylorRockingHorse 


( Desktop I 

Cancel | 

I Open I 


□ Show Preview 


Figure 2 ihe OpertPicltireFtie dialog box with the 
pn^ietv section colla/md. 


OpenPictun^Rlersrc 


0 


ALRT 


n WINDS fixam OpenPicturefilersir 10 B 


Size 


128 

29 

A 

’W 

4- 


figiite^ 4 Ihe OpenPictureFile resources. 


The remaining one resource is a WIND resource with an 
ID of 128. Neither the placement, size, or type of tliis 
window is critical. The program ends with a click of the 
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mousf liuttOHt so the window df>esn*i require a close box- 
And ihe program will resize ihc window to match the size of 
the picture contained in a selected picture file^ so pick an 
arbitrary initial size for the window. You may want to mark 
the window as initially hkUlen so that the program's resizing 
of the w indow isn't visil)le to the user. 

After creating tliese three resources, save and close the 
resource file and get ready to start in on llie pniject file. 

Crfating iiui OPENPicniREFn-E PROjEfrr 

Create a new project by laimching CocleWanior and then 
choosing New Project Iron) the File menic Use the 
MacOS:C_C++:MacOS ToolboxiMacOS Toolbox Multi-Target project 
stationary for tlic new' project. Uncheck the Create Folder check 
Ikjx, then dick the OK bullon. Give the project the name 
OpenPiclureFilamcp and chtx)se the existing OpenPiclureFile 
folder as die pmject’s destination. 

Add the OpenPictureFile.fsrc resource file to the project and 
then remove the SillyBalls.rsrc fde. If you want, go ahead and 
remove the ANSI Libraries folder—this pniject won’t be making 
ufic of any ANSI C libraries. 

Now create a new source code window by chex^ing New 
from the File menu.. Save the window, giving it the name 
OpenPictureFile.c. To add the new source code file to the praject, 
ch(X)se Add Window from die Project menu. Remove the 
SillyBalls.c placeholder file frt>m the projea window. Now youTe 
all set to type in the source ctxle, 

[f you want to save yourself a little typing, log on lo the 
Internet and visit IVhicTech's ftp site at ftp://flp,mactech.oom/src/. 
Tliere yt)u1l find the OpenPiclureFile Miurce code file available 
for downloading. 

Walking Through the Source Code 
Openl^ictureFlIe staas witli die definition of a couple of 
constants. The amsiani kALRTResID holds the ID of die ALRT 
vmmnx used to define the errorhan<iling alert. kWINDResID hokLs 
die ID of the WIND resource used to define the window that's to 
hold the picture thafs stored in a u.ser-seleaed picture file. 

consnuitt 

iUdfifine kALKTReslD 128 

ildefine kWINDResID m 

Next we define our own data structure—the Wind Data 

Structure that holds data (in this case a reference to a picture in 

memory) that’s to eventually lie paired with a window. 
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Wc'll use a global variable to keep track of the one 
window that the program opens. If you modify this program 
to give it the capability tu open more than one window at a 
time, then g Picture Window can be used to ptrint to the active 
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(frontmost) window. 

/“*^”*”****”* j*lcjhal variables ******* “““"*7 
WindovPtr j^PiciureWlndow: 


Next come tile pmgmm^s function pn)toiypes. 

void ToDiBoxInltt void )i 
void OpenExistingPictt[tpFile( void J; 
void Si^ePictureWIndowC void ); 
void UpdatePloturRWlnd<Jw( void ) ; 

void BoErrorC *Str^55 errorString ): 

The main() funciion of OpenPictureFilc l)c^>m,s with the 
inithilizittion of llic Ttx))b«)x. Then the application-defined 
function OpenExistingPictureFile() gives the user the opportunity 
to oj:)en — you guessed it -— an existing picture file, fiefore 
displaying tile file's picture in the window, we call tlie Ttx>tlx>x 
I unction ShowWindow()to display llte previously hidden window. 
The upplicatHm-defined function UpdatePictureWindow() is 
responsible for refreshing the window's contents. A while kxip 
wails for a click of the inou.sc^ burton and serves as our 
pnigraiiVs means of delaying its own termination. When that 
click occurs main(), and the program, ends. 

void mftJnC void ) 
t 

ToolBoxinltO : 

Op^oExlstlngPictur^^FileO ; 

SiiePicturpWInriow()i 
ShowWIndowt gFlctuceWindow 1; 

UpdatePictureWindowO: 
while ( IButtonO } 

1 

'file TfK)lI'>ox initialization function ToolBoxlnit() remains die 
satne as previous versioas. 

void ToolBoxInit{ void } 

( 

InitGraK ^qd,thePorr ); 

InitFonteil; 

InitWindovisO i 
rnltMeniifif) 1 

rnitBlalogaf uii ); 

TniiCursor(3 1 
I 

the OpenExistingTextFileO funaion ts tcspoasible for die fjulk of* 
die fjne gram's work, rakes care of itkjsi of the tasks discussed in diLs 
article. Tlie routine starts with a number o{ variable declaratioas. 

OpcflUxistitigPictiircnic »««»«««•/ 

void OpottEKistlngPictiireFile( void } 

I 


SFTypeList typcList “ 1 ‘PICT’, 0, 0, 0 1; 

StandardFileReply replyj 

short fileRefNum: 

long fileLength: 

Size pictSize: 

Randle plctureBuffer * nll^ 

WlndUataHa^idXe theData: 

PieHa-ndle pictureRsndle; 

StandardGetFilePfeviewO is first called to display the 
standard open fde dialog box. After the user dismisses tlie dialog 
Ikjx (by clicking the Cancel or Open button, or by double^ 
clicking on a picture file name in the dialog !x)x list), the sfGood 
field of the returned reply variable is examined. If tlie user 
canceled, the program calls DoError() to cjidt. 

StatjdardGetFilePreviewC nil, 1, typeList. Areply ): 

If ( reply,sfGood = ) 

DoZrrorC "\pError selecting a file." 3: 

If the user didn't cancel, but instead made a selection, a 
new window' Is opened, A call to the Ibolbox function 
SelWTitleO sets the window's title bar title to the name of die 
selected file. After that the window's port is made the current 
port to ensure that the eventual display of the picture occurs in 
thi.s new window, 

gPictureWlndow ^ GetNewVlndow( kWINDReslO* nil. 

(WlndowPtr)-lL); 

if ( gPictureWindow =“ nil ) 

BoErrort *‘\pError attempting to open a new window." ); 

SetWTltlel gPlctureWindow, reply.sfFile.name ); 

SetPorif gFictureWindow ): 

A call to the Toolixix function FSpOpenDFO opens the 
selected file (if no file wa.s selected the program will liave 
iLTininated before this point), and calls to GetEOF() and 
SetFPosO determine the file length in bytes and set the file mark 
lo the appropriate place in die file for reading to start (iliat i.s, 
die 512 byte file he^ider is skipfK^d), 

FSpOpcfiDFt fcrepiy.sfFile, fsRdPerin, &rileRRfNUBi ): 

GetE0F( fil^RefNtiiQ. iflleT.<;ngth )i 

SetFPoE( fileRefNiim. fsFromStart. 512 

■['he function GetEOF() returns the file's total lengdi. From 
that we subtract the 512 byte header size to pit)vide the program 
with the .size, in bytes, of the ptetum data itself. 

pictSize = filetength - 512; 

Now wc create a file buffer. Tlie buffer is an area in 
memory in which we temporarily store a file's picture data. Into 
this bufler memory we read the trontents of the user-selected 
picture file. After that we set a local PicHandle variable to 
reference this same area of memory. 

plctureBuffer KewHandleClear( pictSize J; 

HLock( pictureBuffer ); 

FSRoadt fileRefNum. iplctSiz^*, 'plctitroBuffer ): 

Hlhlockt pictur^Buffer }; 

pictureflandle = { PicHandle JpictureBuffejr: 
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At this pf>int we've got the file's conlenLs stored in 
titeinory and referenced by a PicHandle variable. Now we 
need to create a new stnicture of the application-defined 
type WindData and set that structure's windPict field to 
reference lliis same area in memory, 

thflDats * (W{ndDfliaJlandle)NevHandleClear Isiajeof tWlndOata)); 

(* M hcDala) ,wiridfict pictureHandle; 

We finish the routine f)ff by setting the window's relCon 
field to hold the handle that references the WindData data 
structure in memory, hater, when we need to access the 
window information (the picture) for this window we'll be 
able to readily retrieve it. 

SetWEefCont gPictiire^i^tEdciv, (long]tlieData J; 

i 


In this program the main use of the applicaiion-clcrined data 
structure will lx: to hold a reference to a picaue to draw to a 
window. Tliere is, ht)wevcr, t>ne other use for the picture—we 
on also use it to determine tlie size of die window in whic:h it's 
to Ix! displayed. Our SizePictureWindowO funaion does that, 

. 

void SlzePictureWlndowt void ) 

[ 

WlmiOataaandla theDataj 

long wioHRefCoTi: 

FicHandIfl p ictiircHandle; 

Rarr piclHactj 

shot I pictWidth: 

ahott pictHeight: 

After the declaration of several Uxal variables, 

SizePictureWindowO makes a c’all to GetWRefCon() to jvirieve llie 
handle to llie window's sufiplemenral thita. A typecast llien coea'es 
this long v’^dtie to a handle to tlie WmdData data structure, 

ivindRefCon = GetWRefConf gPictureWindow 
theData = (WlndDataRandleJwlfidR^fCon; 


To retrieve information from the data structure we double¬ 
dereference the data structure liandle and then chixxse the field 
to access* In our example, the data struaum consishs of just a 
single field — the windPict field. 

picturf^Hflndle ' (* Hhenats) * windPict: 

The remainder of the SizePictureWindowO function is 
devoted to deteriiiining die Ixjundarics of the picture (by way of 
I he pintire handle's picFrame field), extracting the piclure's 
dimensions from those boundaries, and then resizing the 
window' to match the exact size of ihe pimire, 

plctRect = t* ^plctureHandie)-picFraine; 

pictWidth pictRect*tight - plctlect*left; 

pictHeight = pictRect.bottoo pictRect.top: 

SizeWlndowl gPictuteWindaw, pictWidth, pictHeight* false ); 

I 


Ihe drawing of a picture to a window again involves 
actx:ssing the data siniaure associated with dial window, 
UpdatePictureWindowO begin.s with local variable declarations, 
and then calls GetWRefCon() to locate the window's 
accompanying data structure* 

/******•********** llpdatcPktyrcWindow .'*"7 

void UpdatePictiireWindovt void ) 

I 

WindDat aHand1e th eDa t a; 

long wlndKefCon: 

PicHandle picttireMandle: 

Rent pictHect: 

short pictWidth; 

short plctHeight; 

SetPort( gPictureWlndov ): 

vindRefCon = GetWRefCon( gPiotureWlndow ); 

Typecasting provides a reference lo the window's dita. 
From that data we retrieve a reference to die picture that's 
associated with the window* 

theData = {WindHataHandlelwindRefCoii: 
plctureHandle ^ (•*theData)* windPict: 

Code similar fi>und in tlie ju,st-di.scussed funaion 
SizePictureWindowO follows. Here again we detcoiiine die 
IxKjndaries, tlien die dimensions, of the window's picture (so feel 
free to write a single, aimnion, function that handles this task!), 
Insirad of using this information to lesize die window, diougli, now 
we use it Ui draw die pkluie snuggly in tht‘ window. 

pirtRect = (**plcltirt?!latidle) .plcFrame: 

plctWidth = pictRect.right - pictRect*left; 
pictheight = plctRect*bottom ■ pictRect.top: 

SetReetT fepictRect, 0* 0* pictWIdth, plctHoigJit ): 

DravPictureC pictiiraHandle, &pictR^2^:l ); 

1 


DoErrorO should kx)k quite familiar io you—it's the same a*s 
previous versions, A oil to DoErrorO results in the posting of an 
alert that displays an afipropriatc error message. When the alert 
Is dismissed, the program ends. 

void DoErrorC Sti:‘255 «irrorStrlng ) 

I 

ParamTextf errorStrirg* ‘*\p"* ): 

Sti>pMert( kALRTHeslD, nil ); 

ExitToShellO: 

\ 


RlTNMNG OPENPlCRTRliFlLH 

Run OpenPictureFile by choosing Run from 
Code Warrior's Proiect menu. After the code is compiled, 
Code Warrior launches the OpenPictureFile program and 
displays the standard open file dialog box. Use this dialog 
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l>ox lo ,Hclect any picture file on your l<K'al drives. If you click 
the Cancel biittun, rhe program quiLs. If you instead select a 
p id Lire nk% that file will be opened and its contents will be 
dis(>layed in a new window. Note that the window is sized 
to match the exact size of the picture held in the selected 
picture file. Clicking the mtmse button ends the program. 

Tin. Next Mon™.- 

Last nionili we covered a lot of new material, including 
the details on how to create an application-defined data 
structure that can be u.sed to hold data of any type. You read 
how you can make good use of such a structure by 
associating it with a window so that the information held in 
the data structure "belong.s" to one particuiar window, In last 
month s example code you saw how this data structure can 
htjid tite text frtmi an existing text file. This mtjnth we worked 
with a simitar structure and a similar scheme to associate the 
structure and a w'intlow. Here, though, we set things up such 
that our code created a data structure that held a picture from 
and existing picture file. I'ogether these two examples sliould 
provide yoti with proof that we're on lo a vtv)' pow'erful 
tecfini<|ue. While our examples have focused on data in files, 
you should l>e aware of the fact that you can .set up your 
window' data structure sucli that it also (or only) holds other 
types of data. Ft>r instance, here’s a structure that keeps track 


of a string, the text from a text file, a picture from a picture 
file, and a picture that's .stored in a resource: 

typedef struct 
\ 

StringPtrwindString: 

TEHattdle windText: 

PlcHandlevindPictl; 

PicHandle vindPi£t2: 

I WindDaLa, 'WindDaraPrr♦ *•WindDataHandle: 

In the above example yt>u may wonder which picture is 
derived from the picture file, and wliich [>icture comes from 
a resource. The fact Ls that you cartel tell the source of rhe 
piety re because the source doesn't matter. In this monilFs 
and last month’s Getttnf^ Started our emphasis has been on 
extracting data from files so that you'd learn some file¬ 
opening and file-reading techniques. But a data striidure 
doesn't care where the data that gets stored in its fields 
comes from — it just wants it.s fields to reference valid data 
in memory! Knowing this, you should be able to combine last 
months OpenTextEiie code with Lliis nionth’s 
Open Piet 11 reFile code, and add some data-handling code of 
your own to create a very ptmerful program that w'orks w'ith 
all sorts of information. As you w^ait for next month's article, 
go ahead and get started on that project now! WB 
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A Programmer's 
Introduction to Developing 
for Mac OS X 


bane of modern opemiing sysleiriK. The drawer is a sub¬ 
window which is attached to a parent window and can he 
pulled out as need arises. 

The right-most top button on w^ndow^s switches the 
interface into single win do w^ mcxle 


Introduction 

The release of Mac OS X Developer 
Preview 5 in late February lias uslierc'd in 
a bi'iive new' world for both traditional 
Macinit>sh and veteran Gjcira OpenStep 
programmeis. Tlie new Atjua interi'ate 
denioetl by Steve Jobs at MacWorld San 
Francisct> is now' in the hands of the Mcic 
vanguard. Tliis release represents a 
convergence of the lies! ideas from the 
Otrbon (Mac OS) and the Cocoa (aka 
Rhapsody/OpenStep) w'«irld.s* and has 
everything y(>u nee^l to prmiuce first class 
applications for the forthcoming Mac OS X 
release late this siimmec 

Without a doubt, the most 
immediately .striking pan of DP5 is the 
Aqua Interface — a truly liquid and 
almost candy-like user iolerhice that is a 
pleasure to behold. 

The use of subtie, fuzzy shadows on 
windows, semi-transparent title bars, 
animated effects and '"gum drop” 
controls represent a lireakthrough in HI 
design and an entirely new look ami 
feel for Mac 0;S X. Revolutionary 
interface ctmeepis such as the “drawer”, 
po(>-up and self-magnifying dock, drop^ 
dowm sheets and single window mtjdc 
address the desktop clutier that is the 


@ 


figwue 1. The single uimlow mode selecfkm hutton, located in 
ibe itpfKT tighi comer of a window. 

'Hie singly focused w^intlow' is a hxm for neatness freaks - 
you .select the window you want activatetl and all other windows 
will “genie" away. 

Tlie new Mac OS X Finder spans the Dock, which Ls a user- 
defined set (jf applitaiion and tiot'umenT icons along die lx>ttom 
of the scTcen. Features include “autodiide" and a magnification 
mtxle tt> help the fading eyesight of the baby ixKimer generation. 
As your cursor passes over the miniaturized windows and 
applicatirm tiles, the icons imderneath magnify so you can lietter 
see what's Ix^ing represented. And true to tfie Macintosh Way, the 
Finder lias preferences which allow you to acljust and turn off 
these features if diey don't suit you. 



figure 2 The Dockj healed at ihe bfjltom of the Desktop, the 
mome rolls over the icom in the Dock, they are magnifufd. 


Andrew Stone <andrewest{}ne.ctjin> is the ditef executive haquer al Stone Design Oirp <littp://www.stone .(roiri/> and 
divides his Time l>etween raising children and llama.s and wanting applications for Mac OS X. 
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Your icons should have multiple resoJutions (16 by 16, 32 
by 32, -18 by 48 and 128 by 128) to take advantage of Finder's 
nruignified dock and iaspectt>r, tHhenvise, theyll look rather 
jagged. Apple has provided tools to make tltcse .icns resources. 
Later m die article, you'll learn how. 



Fif’ut-e S* The icon for TextEdiiM^. 

Of great imponance to the existing Mac cominunity is 
“Classic.app*’. Classic is basically the old Mac OS Finder. 
When launched, Classic will let you double-click and run all 
of your old Mac OS applications, without the annoying 
separate world of the "Rkie Box”, also known as MucOS.app. 
These applications' windows appear in the same desktop as 
new Mac OS X applications. 

However, one thing l>ecomes perfectly clear when you 
run an old Mac OS application: it really looks out of place 
and kind of “cheesy”. There is no window depth or shadows 
and yr>ti can only drag the outline of the window. When 
placed side by side with a new application, it appears rather 
pale. If yciur application is to compete on Mac OS X, it had 
better take advantage of the Aqua interlace and memory 
uumagement features of the new operating system. 

So there arc two approiiches to building Mac OS X 
applications and your choice will depend on a number of 
factors. For iradiiianal Macintosh developers who have large 
code bases, using the CarNm .software development kit is the 
fastest way to go. With just a little pruning of no longer 
supported API, you can give your classic Mac apps a face lift 
and gain much new functionality for very little expended 
effort. If you are WTiting a new application, or willing to got 
and rewrite an old one (something which really does need to 
be done every ten years!), then I strongly recommend using 
Apple’s high level, “Five Story” Application Programmer's 
Interface named Cocoa. 

TUI: OmECl SaTORI 

When I first encountered the core ideas at the heart of 
Cocoa over twelve years ago, and realized the elegance and 
power at my fingertips — ! had a major realizalkm that 1 call 
“Object Satori”, 'lliis article aspires to be the eylx:r-equivalent 
of lH.1ng given your first Vup of kooiaid" and Ls geared 
towards Classic Mac programmers, refugees from the Windows 
Wiorld and of course, the Cocoa Choir, The fcKrus of this ankle 
Ls to explain the rationale behind object oriented frameworks 
and provide you with the motivation and inspiration for going 
beyond Carbon into the gleaming sky,scniper of Cocoa, 


1 started my programming life as a HyperTalk scripter, 
and had ntn into a brick wall trying to learn the Mac tc.>ollM)x 
prograituning XFCN's, When 1 heard about the NeXT on the 
comp,sys,imc USENET newsgroup, I was totally intrigued and 
given the hope of a much easier development environment 
Six weeks after a four day crash course at “NeXT Camp" 
in the spring of 1989t 1 bad finished my first Coci>a app. 
Text Art was a type styling program which used Display 
PostScripL U) let you do cool things to type by taking 
advantage of the built-in functionality of the AppKit, Cocoa’s 
user interface framework, 'fhis app allowed you to do things 
that were impossible on other platforms, and yet I had to 
write very little of llic code that did all these effects! 

Tocliy, I have seven applications <www,stone.com> that run 
on Mac OS X Server and are ready for release on Mac OS X. 
Cocoa has empowered a single programmer to produce 
applications that have taken teams of programmers on other 
platforms. The advantages of Cocoa can lx: summed u[) by 
saying it makes pn^gramming easy and fun. 

A Rose By Any Other Name 
What is Coexm? A delicious lieverage that induces a neuro¬ 
chemical rush similar to your first kiss, that is better than Java 
for your health. What a comforting and cvticaLive name that 
makes you want to curl up by the fire! Cocoa began life in the 
late ’80s as the AppKit when a fru.sinited Mac prognimmer had 
a vision that the “NeXT” Mac should be easier to program than 
it currently was. Here we had the easiest computer to use on 
the planet, and it only required tluir you understand assembiy 
language and A-traps to [irogram il! You might remember that 
AppKit founder William Parkhurst had written a plugin for 
MacPaint that allowed you to rotate and flip the selected bits, 
which was really cckjI in '85! 

The AppKit evolved into NeXTStep, which split into the 
Aiiplicaiion and Foundation frameworks of OpenStep, an 
open object oriented API that wa.s renamed “Hhapsody” when 
Apple acquired NeX'f in 1997. I think the failure of Lotus 
“Jazz” should have been a sufficient sign that musical 
mtmikers are to be avoided. You really want a name that 
simply tastes good, thus we have Cocoa. 

Apple is fortunate to have many of the old NeX'F engineers, 
including one of the four original AppKit programmers, Alt Ozer 
who leads the AppKit group. Much has been learned al)out 
object oriented prognmiming in these intervening years, and 
new functionality is conlinually \ye\ng added. What this means to 
us programmers living in the trenches is that we have les,s code 
to write and maintain, and can focus solely on what makes our 
programs diffcreni. 

A Short History of Osject Oriented Programming 
Before we delve into the framew'orks that make up Cocoa, 
it's w^orth stepping back 35 years to iwo c'oncepi,s ihai underlie 
OO programming: abstract data tyjxfs and data hiding. An object 
is a collection of data and the operations (what we call metliods) 
upon that data. Ifs like a black Ixix — we know' rhe inputs and 
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the ouipufs, liur ihe impk-incmotion does ncH eoneem us. Wh;u 
this meMos is iJial we are free from knowing the iritricades of 
eoinplcx code, and yet we are frc'c to take advantage of it, 

Tliis is a radically different t?rograniniing meta[)hor than the 
“functional" progranuning of C, Pascal, Fortran and Basic. In a 
functional programming language, you are telling data what to 
do, and a deep tindersemding of the involved da la structures is 
required. Tf a tlaia structure changes, your cikIc will break. 
However in the Object Oriented paradigm, should the 
impleine!iUitit>n of an objeti change Co a more efficient one, our 
code will continue to work, and in fact, gain all the lienefits of 
the enhanced object. Data is hidden from view\ and instead of 
giving an object detailed insiructions to do something, it knows 
how [o do it by iisc‘lf 

There Is a certain cyber machismo in l)C‘ing able lo write 
hlrc'cs in Fortran or lisp interpretors in C, but shouldn't ilie goal 
Ix" to make our lives easier, not harder? What makes it [Xjssible to 
manage the complexity of large softw^arc is the boundaries 
bcaween modules, that b, the Application Prt>grammed.s Interface 
(API), With regard to intellectual discovery, I Ixlieve in ct^nilive 
dissrclence, l>ui when it comes to prognimming, I Ixlieve in Ixing 
a mtK.{el citizen, and .sticking strictly to the API Ihb adherence 
keeps your Cfxle ninning when there are new system releases, 
and purs the burden of correct operation onto A[)[)lc. wliere their 
programmers can maintain and enhance your code! Moreover, 
wfien features are added to Qxoa, your applinttioo automatically 
gains the new- features, even without recompilation. 


Where Do 1 Start? 

learning a new programming environment can seem like an 
imposing task. I,uckiiy, everything you already know will make 
it easier lo Icam Cocoa. In fact, most of what you have to do is 
<(011 doing things the hard way! For example, you'll never have 
to clone another event loop if you don't want to. Often yoifli 
find ifiat if a task is difficult, then you are approaching the 
pn)l)lein in the wrong manner. 

You can program Ctxoa in any combination of tlie big three 
object oriented languages: C++, Objeeiive-C and the highly 
hy(>ed Java. Objealve-C is tlie choice of long-time Cocoa 
programmers and is the actual language used “under the Itood" 
in the major frameworks of Cocoa, Its <lynamic runtime binding 
allows icm% elegant and reusable c<Kle. 

Although the total Ctxoa API is laige, it's very at:eessiblc for 
two reasons: you can learn it as you use it and die methods you 
call have a consistent and natural language naming pattern. For 
example, to allow a text ol>jcct to accept dragged and drojijxfd 
graphics, you'd wTite: 

l!ijyTextVii*w setlmp^irtGraphics :YESl; 

// niy tlxt ViLTiv: set I mpt »ftG riphit-sCtrue); 

An even easier way is to create the text View in Interface 
Builder — Cocoa's visual user interface design application. 
Simply click the sw'iich in the NS'i'extView rnspeetor that says 
“Allow Graphics”: 


Mac programming is complex. 
The answer is easy. 
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figure 4. Mo£ii{yiftg a text object’s firoiKTlies using 
Interface Builder, 


To bring up a save panel and save your text replete with 
graphics, you simply write: 

// Ciinh m irhsturtcc of the global Save Rim.1: 

NSSavcPanel •savePfinel =" [MSSavc^Paael savePanel]; 

// save ihc i€xi in m rt(d file wra^fx-f 

[savePanei setTypffi;: [NSArray arrayWithObj^et :#"ri Td”]} j 

// mn ihc save panel riKKhlly to gel Itic filename 
if t fs??veP^nel riitiModalForDirectoryinLl file:nil 
relaL Ive'i'oWindow: [myTextVlew window]]) 

// I he itxi ubjett knows how to savt iist lf: 

[myTextViev writsRTFDToFile: [savePanel fll#!iiaftie] 

ntoiiilcal lyiyESj ; 


Under the Sheits 

A powerful new interface concept in Atjua is the notion 
of document modal windows or “sheets". [>o you hate modal 
wimlows as much as I do? Sometimes, you need them. 
IRjwcver, ifiis %vill freeze uji your application until tlie user 
deals with ifie modal panel. Apple has taken a fresh look at 
nuKiality and came up witit this realization: there is no need 
to siof) user interacrion except in the window that requires 
modal attention. A sheet is a drop clow n window that appears 
as if it is coming out of llie title bar of the dijcument window: 



The rest of ytjiir applicaiion remains available for user 
interaction. 

In Developer Preview 3, these "sheets" are only availalde in 
the Coetja frameworks, but Carbon suppm will hopefully be 
forthcoming. Implementing sheets Ls quite easy - you simply add 
tile new pammeter relativeToWindow:(NSWtndDW *>aWindow 
to your old favorite iiKxial invoking methtxLs such as mnMtxlaJ 
and NSRimAlertPanel family. 

SiTPORTiNG Mac OS X Sevtr and Mac OS X 

Since many developers have wanted to be able to ship 
applications for lx)th Mac OS X Server and Mac OS X, and it's 
tricky to maintain multiple sotirtx" ccxle trees in synch, here*s a 
tip for cTc^ating a single scaurce tree that compiles under lx>di 
Mac OS X and Mac OS X Si*rver. First, since we want the future 
to Ix" uncomplicated, we'll define a variable only if w^e're 
compiling under Server, OSX_SERVER. In Project Builder's Build 
Insjx^ctor, you add "-DOSX„SERVER" in the Cflags field, 'Ihen in 
y(>ur source code, you can have constnicts such as this to take 
advantage of the new Cocoa features, but still compile on Server: 

// mn rhf save piuid nHxtaUy tci get the filename 
If (l:s:£iv€p&n€i runKodalFoffllrect(jry:nli fiie:nil 
filfridel USX_SEHVER 

telativeToWindnw;rmyTextVlew window !1 
tfendif 
) 

fnyXestVlfiw writeKTFDToFile: IsavePanel rtk-riiinie] 

Htoraicaily:¥ESl : 

Since you want your nib files to be tuned to the new 
Aqua interface and since nifis saved under Aqua cannot Ik? 
read by earlier releases, you will need to inclucie an extra set 
of nibs. The NIB arc'hiteclure includes platfonn-dependem 
suppon based cm the suffix of the root name: -macos for OS 
X and -inacinio.sh for Server. For example, if your main 
document nil) was "Document.nib’', OS X w^otild first try to 
loail the nib named "Document-macos.nib". Again, since we 
w'ani the future to be simple, rename your Server nib to 
"DocmmenMuacintosh.nih", and let the new af)ua nib be 
simply "Document.nib". 
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Model View Controller pAni-RN 

If you really want lo use itie power of Cocoa, y€)u slK)uld 
take advantage of the Document ArchiLcciure, HrojeetBuilder Is 
the focus point fur development with Cocoa - it manages all of 
your files and resources, lets you edii^ build and debug your 
applicaliun, and provides central access to all the other editors, 
such as InterfaceBui Icier for your interface files. In 
IhojectBuilder, when you create a new project, selert 
‘'Document Based Application’* horn the pop-up list. 


gel annoying, it s good to provide a menu item to allow the user 
lo toggle tile feature. This menu item ''Check Spelling As You 
Type*’ will be connected to the action 
toggleConlinuoiisCheckSpelling:, NSTextView's API to turn 
ctintinuous spell checking on and off. 

As of the writing of diis article, Inteihicelkiilder docsn'i 
autoniatieally add this feature to the delaulr Edit menu, so you1l 
have to do it yourself. To add “Check Sjxhing As You Type" to 
your application, fiillow these steps, most of w'liich are to 
reorganize the spelling functionality into a sub-nicnu group: 


Name: 

-ProjectType *- - ---— 

Ppocument Based Appticatiiiri t] 

A project that produces a document 
based appUcation. 


figure 6, C'reaiing a Document Based appHvalion 
in ProjcLt Buiider 

'Ihis gives you a lot of functionality for free, and makes 
creating full featured apjilications with multiple document 
windrows <and even multijile w^indows on each doenjmentT) 
extremely easy. 

The DcKument Architecture is covered in detail in 
/System/Library/Frameworks/AppKit.framework/Resources/English.lproj/Docu 
mentalion/Reierence/ObjCdassic/Classes/NSDocumenthtml on both 
Server and Mac OS X, Conceptually, a document liolds the data 
or Model, but does not “show*' ijie data. Displaying tlie daUi is 
the responsibility of the View, Manipulaling the data through 
interface controls and inspectors is the bailiwick of the 
Controller. By separating out the.se responsibilities, many 
lienefits are realized: 

T The clear separation of ta.sks avoids spaghetti code and 
misplaced cxxle 

2. Components are separate and thus more easily reused 

3. A document can dusplay its data in several views 
simokaneously 

4. You gel a robust architecture whicli can grow without 
getting rickety 

To kx)k at the source code of an applic^ation which is 
stnictLired along the MVC design pattern, check out 
/System/Developer/Examples/AppKit/Sketch. 

By utilizing the Cocoa API, your application will 
autoni^ttically gain use of new features tltat aa" rolled into the 
provided classes. Sometimes, you might just have to provide a 
new menu item, so tlie user cun access the new functionality. 
Case in point is a new feature for NSTextView in Mac OS X r)P3: 
the ability to see misspelled words as you type. Since this c!an 


T Open your application's main nib file in Interface Builder 

2. Click on the Edit menu to drop it rlow^n. 

3. Drag a new^ “Submenu” from the Menu paletie onto the 
Edit menu 

4. Rename the “Submenu” to “Spelling” 

4. Cut the “Check Spelling” menu item from the Edit Menu, 
and Paste it onto the Spelling submenu 

6. likewise, cut the “Spelling,,.** menu item, and paste into 
tlie Spelling submenu. 

7. Double-click the "FirstResponder” icon in the JB 
Document window. 

8. Click the “Actions” Imtion of First Responder, to drop 
down the actio as, 

9- *iype <RETTJKN> lo add a new action, 

10, lype in "toggleCantinuou.sChL’ckS|>t4ling:” as the action name, 

11, Change the title of the “Item** menu item to “Check 
Spelling As You Type”. 

12, Connect this menu item to the First Responder icon, and 
choose the toggleContinuousCheckSpelling: action, 

13^ Save, build and voiD: 


□_ WHiiftaw __ 

The words which arc rmsspcilcd npear in red 





Figure 7. Continuous Spell Checking highlights 
misspeUed words in red. 


EXI'ENSIBII.ITY 

In Uie Sheet stTeenshot earlier in die ariicie, you'll notice 
that the standard save panel has an additional button, 
“Resources”, Throughout Ccxroa, you 11 find easy ways to add 
functionality to the exist mg Uk)I Ijox, and most standard panels 
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have a metliod 

“sclAccessoryView: (NSView *)aView" 
to add custom user interface elements 
and functiomility. 

WeVe found that it rc'ally lielps 
users if they save all of their 
documents in one standard (and of 
course user configurable!) l(K:alion. 
With the **Resources" huLlon, a single 
click takes them to the folder from 
which our design application Create 
loads its resources. It’s possible to 
create an Interface Builder ^'nib'* Rle to 
hold the single button, hut that's sort 
of overkill because you air loading a 
window that you do not need, 
instead, lei’s look at the code to create 
and configure the Initton 
prcjgrammatic'ally. 

Subclassing a method is one w ay 
to (|uickly add funciionaliiy and still 
take advantage of the hard work done 
by the superclass. Since Create uses 
the Modcl-View-Coniroller pattern, in 
the NSI3cx:umenl sulx:lass, we simply 
sulxiass runModalSavePanel : 

// aqua hiinons ait: HI IGE, wt iitt 
BiriTON^IltJCTHT accordinR to platfiirm: 

OStLSERVElt 
BUTTON^HEIGm’ 24.0 

ifelse 

miTTON HEIGHT 34.0 

j'fendif 

// rcaitj useful MACRO 
tfdefine IS_NllLL(x) (x = nil || 
fx isEqualToSttrlng:^’"*!) 

(in l) runModalSavePanel:(MSSavePanel 
*)uavePanel 

witMccesaotyView: (NSViev 
•)accessoryView 
f 

static BOOL firslTime - YES: 

// well add the :w;ccssory view on the fifst time 
// through here: 
if (firstTima) { 

NSllecL sFrama = 

[accessoryView frame]: 

// aiJk our class to create the button for us: 
NSButton •button ^ [[self class! 

1 Ibra ryBiitton: aFrame. size. he! ght 
inSone: [savePanel sjotiaJJ: 

// mke the acccsstiry view larger to hold 
// oorocw bunon: 

aFrame .size *110 i ght +” 

BUTTON. HEIGHT; 

[accessoryView selFraiQe:aFraiiiel; 

// now, stick the huuon uito the accessoryVkw: 
[acesKSoryView addSubview:button]: 

firstTlme ^ NO: 



Sborf iCart: $149; Tat! fCart: $199: Great accessories. Oil us at 800-325-3841. 
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// Ici iJie NSlXicunicnt, do ilit rcii! work: 

retutn fsu(>c?r niiiModaiSjavePan^lisavePanel 

withAcccrs soryView: accessoryView]; 


-1 (NSJiliuuon *)libraryBtitton: {fl oat)originY inZone: (WEsZone *)aone ! 
NSButtoii * button: 

// Use a kiailized version of the Jlmion lidt fi)r intcmafional clients: 

NSString ‘e = 

NSLoeallzedStr 1 ngFrontTabie C@'’ReEonrc-es“ .©"Moktinath” * "button 
title for SavePanel/OpenPansi to go framedlately to user files'*}; 

// the size of the button is controlled by the locaJ nitiasage font 
// by passing m^-L<J%it means “use the system’s default size" 

button - [fNSButton aIlocWithZone:zone ] 

i n U W1 ihPrante: NSMakeRect (I ^ 0, o riginY. [ [NSFont 
nieHEage?ontOfSize;-l .0] widthOfString:n] + 
10.0 ,BUTTON_ilKlGHT)J: 

// set lip the btiUon's tide and behaviour: 

[button setTitleisl; 

(button setBezelStyle;NSPuEhButtonBezelStyle]; 

// set up ilie button's target and acUou: 

(button setTargot;selfj : 

(button seiAction:@selectorfgotoLlbraryAction:]]; 

i: el urn button: 

I 

// here's the caJHraek method that (Keurs when the user po^^es the button: 

//Wc place this in CreateDocumcni Class so that we don't hiivc to worry 
// alxiut an instance of Createlkxluincnt being freetl: 

// '111 is shows how to do simple recti mton: 

//We riavcrsc down the view htemrehy looking for die NSDnswscr 
// A5 long as there’s just one, this ctwlc will wtirkl 

+ (IBAction)goto!,IhraryAction:(id)sender [ 

NSSavePanel 'savePaneJ “ (NSSavePanel *Hsender window]; 

// begin the recursion of the lop level view in the Save Panel: 
fnelf findBrowserInView:[savnPatiel contentViewll: 

[ 

+ (BOOU findBrowEerTn’View: tNEi\/iev Mview I 
// when wc find the browser, set it's paiit and we’re done: 
if [[view InKIndOfGlassHN;>Browner class]]) I 
//The libraryFokfcr is a user preftfence, with a sane defaiill: 
fCNSRrowser *)view setPath:[[NSUserDefaults 
siandardUserDefaultsl 0bJcclForKey:@"LibraryFDlder''l J; 
roLutn YES: 

I elsg I 

//we'U dtj a iiavetsal of its sitbvM-ws,if any: 

NSArray 'viftWE “ [view subviews1■ 
int i = [views countj; 
while (1- > D) J 

// the beauty of recursion: less code, less fiUing: 

3 f C [self findBrowserlnViewi [vit^ws objectAtlnde^xi I ]) 
reiurn YES: 

1 

] 

return NO: // we didn't find dw l>rt>wscr in this subview 
f 

So now, whttn ihe Sheet Savepanel is run, you can click the 
Resources button to instaiuly be ininsponed to your Create 
Libraiy Iblder. 

Name: |urttlttacl-l ~| 

( Resources } 

Figure S. A Sm^ Pam! with ibe Resources buUon added. 


Making Muitipije Resoli tjon Icons 
As mentioned atove, tlie new Finder ciin display your application 
and docutnciiL icons at several resolutions depending on the view and 
User preference. By default, if your icon just has one size, that size wtli 
get stretched or sliiunk to liic display size, Tliis can pnKiuce njisty 
jaggies and stfuisheti, unrecpgniz:il)le [jits. At the time of this writing, 
tliere are only command line tools to prodiic’e icons in ilie ^liTts” format, 
but itts not too hand. For developers aiming horn Mite OS X Serv^er, 
heiv's liow you make one: 

h Create a tih of your ia)n at c^ich desired resolution. GtKxi ones to 
use are (6 by l6. 32 by 32, 48 by 4B and 128 l?y 128, You can use 
applicadoas like CnKite or llFFany to make these. For fliis example, 
we’ll assume a naming convendon of appl6.dff, app32iiff, etc, 

2. Goml>inc the tiffs into one multi-resolution tiff: 

/usr/bin/tiffiiLil cat appl6.tiff appSZ.tiff app^S.tiff 
applZS.tirr -out app.tiff 

Or if you just can't stand the command line, run, don’t walk, to 
<wvvvv.stepwisecom/Softrald> and search for Malcolm Craw fore fs 
'^Apf>Icon’* * a GUI frontend to tiffutil - cat, 

3, Under 01^3, u.se die providetl utility ^‘dff^iems" to make the final icon: 

/uar/bln/tiff2icns app.rlff 

You’ll see the newly created "app,icns^ - add lids to the 
RcMHirces suitcase of your proiect in Project Builder. 

Wheki, ro Go For More 

The develoiTer di.strihudon of Mac 08 X Is loaded wiili sample 
applications and eJuimpIes in btjth ObjectiveC and in lava 
(/System/Developer/Exannples/AppKjt). Documeniation is in 
/System/Documentation/Oeveloper. My advice to newcomer is to take one of 
these applications and liegin adding new featiire,s to them. This IcLs you 
get your feet wet, without having to stait lk>m .scraiclr There are many 
articte atout Ctx-Yxi piogramming awiilahle at wvwv.Stepwise.com and (Ve 
written a nuinfxfr of useful articles and objects at www.stone.coin/dev/. For 
example, “sWord” — rtie simple word processor, Ls a .step hy step 
intjTociuaion to Qyaia |>it)grainming. Ycxfll build a w'ord prrxessor 
cafxihle of handling kerning, fijsdllcudon, sub and superscTipting. full 
Llnicixle supjxirt, spell checking, multiple foni and panigraph sTyles, 
drag and drop of enilxilded graphics and colors, rulers wiilt adjusmiMe 
tab slops, reading and writing of confonning 1FJF13 files, all in less tfian 
13 lines of code! Ycju cannot do this in any other dt^velopmenr 
environment on tlie [)lanei. 

With Cocoa you can c|uickly create full leaiured 
applicatums, with many reusable components. Your code will be 
in a readable English-like form, and if you folkjw the design 
pattern of Model-View-Controller, you’ll have a basic 
architecture which will support many .stories of future feature 
growth. Goodbye spaghetti, hello maintainability! 

IVe jusi barely scratcficd the .surface of wliat's new^ and ccx>l in Mac 
OS X ^d over the montlis to conie, kx)k fV>r tips, techniques and 
trouble-shooting in upctjming issiies of MacTeck QQ 
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W febCGtdlos is a complete eCommerce and dynamic web 
publishing solution, utilizing existing web server software, 
WebCatalog provides the capability to design and operate online 



storefronts with all the features found in leading sites. Build unlimit¬ 
ed storefronts with our Storebuiider wizard directly from your 
browser - even upload your product grapfiics! WebCatalog pro¬ 
vides multiple platform support for Windows, Macintosh and 
UNIX It's the easiest way to lake advantage of the web and to 
change how ..and wi^re... you do business. 

• Unlimited storefronts • ODBC, SQL support 

• High-speed internal database ■ Electronic shoppirtg cart 

• WAP-enabled sites • Invoice calculations 



1.800.477.1543 • www.smithmicro.com/iscl 
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PROGRAMMER'S 

CHALLEIUCE 


by Boh Hoonstra, Westford, MA 


BigNiim Math 

Back in September, 1995, we conducted an RSA Cliallenge 
that involved raising large integers to integral ix>wers, modulo a 
third integer. The representation we used for diose huge integers 
Wits a BigNum type, where each digit t)f the large integer was 
stored in a byte. ITiat representation and die operations on it 
were not paiiicukdy efficient, and this month we will belatedly 
recitfy that situation. Your Cltallenge is to implement a new 
BigNum type, of your own design, along with a number of 
aritiimctic operations on these BigNums.. 

rhe prototype for tlie code you should write is: 

typedef struct BigNum ( 

long lengtkltiDiglts: /* length of the BigNum in digits 7 


void ‘blgNumDataj 

1 BigNum; 

t pointer to BigNum data 7 

BigNum NewBigNum ( 
char sign, 
char digitsII, 
long tiumDiglts 

): 

/* otaw A BigNum 7 
/•+! or a 7 

r digits to be made into a BigNum 7 
r number of digits 7 

void DisposeBigNum ( 
BigNum theBigNum 

]: 

/* Uis|xjM: of a BigNum 7 

/* the liigNum to be dispo?ial of 7 

BigNum AddBigNums ( 
BigNuoi blgNumA, 
Bl^un higNumR 

): 

r sum rwo BigNums, letiimitig a new one 7 
r Rtum the sum A+B V 

BigNum SubtractBigNums 
BigNum bigNuraA, 
BigNum blgNuHiB 

( r subtract two BigNumsi renirning n new one 7 
/* return the difTeretice A B 7 

BigNum MultlplyBlgNuMs 
BigNum bl^uinA, 
BigNum btgNuiaB 

( /• multiply two BigNums, returning a new one 7 
r ret urn ilic product A'B 7 

BigNum DivideBigNuros t 
BigNum bigNumA. 
BigNum blgNuaiE 

]: 

/* ilivklc two BigNums, retumihg a ticw one 7 
r return the cpioiient A/B, discarding the remainder 7 

BigNum WocjBigNums ( 
Rl^uii bigNumA, 

BigNum bigNuinS 

1: 

/* divide two BigNums, returning a new one 7 
/* return the remainder A%e,dLsc^rtluig il^^ 7 

BigNum PowerBigNuins f 

BigNum bigNumA, 

BigNum bigNumB 

); 

r eatculare one Bjgnuin. to the i^>wcf of another, 
rctummg a new utie 7 

/* reluniA raised to the ptjwcr B, discarding the 
quotient 7 

BigNum SqrtBigNum ( 
BigNum bigNumA 

r find the sqrt of a BigNum, retunung a new ime V 
r return the square root of A 7 


long /* numD^gits 7 BigNuaiToDigitst f convert a bigNum to decimal digits 7 
BigNum bigNumA, t bigNum to be convert^ to ttcdniai digits 0'9 V 


char ‘sign, 
char digits [J 


t fttiim +1 or 1 V 

r decimaJ digits of bigNumA. prrceedeti byif 
negative 7 

r storage for digits piealicjcatcd based on 
bigNumA-kngthInOigiLs 


'rhe first thing yt>u need to do is decide on an internal 
representation for BigNums. Then you need to write a 
NewBigNum routine that will create a BigNum from a sequence of 
numDigits digits and a sign value. Your NewBigNum code is 
responsible for allocating memory for the BigNumData. 'Hie 
DisposeBigNum routine is responsible for deallocating that 
memory. The caller of your code is responsible for pairing every 
NewBigNum call with a DisposeBigNum call, and the two routines 
should be implemented so as not to create any memory leaks. 

In addition to the.se alloc'^ition and deallocation routines, you 
need to write code to perform addiiif;)n (AddSigNums), subtraction 
(SubtraetBigNums), multiplicatioo (MultiplyBigNums), division 
(DivideBigNums), remainders (ModBigNums), and exponentiation 
(PowerBigNums). Each of these routines takes two arguments, 
calculates the result, and returns the result in a new BigNum 
alkKmed by your aide. Vjwh of these returned BigNums will also 
)'>e disposed of l)y a call to DisposeBigNum l^efore the test is over, 
altlioLigh they might lx: Lisetl for cakitlaiions in the interim. 

just to spice things up, you also need to prtwide a 
SqrtBigNum routine that calculates and returns the integer square 
r(X)t of a BigNum, die largest BigNum whose square is no larger 
tiian the original number. 

And finally, to lielp me rletipher your BigNums, you need to 
provide a BigNumToDigits conversion routine that converts your 
private BigNum data structua- into a sequence of digits, along 
with a sign, and returns the number of digits in the decima! 
representation of the BigNum, 

l‘m not providing inforrmttion on the di.sLrihuik>n of calls to 
tile various routines, except to say dial the arithmetic routines 
will significandy outnumber the allocation and dealloaition 
routines. 'Ihe winner will lx: die solution that correctly completes 
a .sct]iience of arithmetic openttions on BigNums in die least 
amount of time. You are strongly encouraged to adequately 
comment the code in your .submissions. Not only dcK?s that make 
your axle more itnclersundable if it is published as die winning 
solution, but it also helps me track down any minor problems 
that might occur. 

ril close with a plug for the Cliallenge mailing list, where 
you can receive notice of the problems lx?fore the liard-copy 
magazine reaches your mailNix, and where any post-publication 
clarificaiions are distributed. Subscription instruetjons can be 
found at <http://www.maaechxom/progchal!enge/>. 


M^ac^Tkch • May 2CXX} 
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Tliis will be a native PowerPC Challen^^c, owing ihe 
C(xleWarrior Pro 5 environment. Solutk>as may be codec! in C, 
C++, or Pawcai 

Thrfe Months Aca) Winner 

The February Cliallcngc required readers to calculate a 
minimal Liilin square of a given order, bit in Stjuares arc nxn 
arrays of integers, w^here each tow and each column contains 
each integer from 1 to n exactly once. Congratulations to 
WiUeke Rickcn (The NctJierlands) for coming up with the 
winning solution to the Litin Squares Challenge. 

Kieven readers .submitted eniries to this Challenge, and 
rhetr performance varied widely in efficiency. My test scenario 
was based on 28 test cases, consisting of the l.aiin Squares of 
orders 4, 5, 8, 9, 12, 13, 16, 17, 20, 21, 24, 25, 28, 29, 32, 33, 
36, 37, 40, 41, 44, and 45. I seleaed those numbers because 
tliey foriiied a regular pattern that could be continued as far as 
the solutions would allow, and because they contained a mix 
of (xld numl>er,s, even numbers, perfect squares, prime 
nutnljcrs, and powers of two. My original intent was to test 
even larger numbers, l>ut even the be.si solutions took too long 
to calculate some of the larger numf^ers. 

Even limiting the tests to these cases, some of the soluiiims 
look a long time to execute, so 1 divided ilie tesLs into three sets, 
'llie first set consistetl of tlie lirsi ten test cases, and 1 nin all of 
the entries against diat set. Three of die entries either did not 
complete all of the cases, or calculated a Latin Square that was 
huger than the squares caleulated by odicr solutions, Itiree of 
the entries had fast execution times for the ten cases, and one 
more had an execution time within roughly two orders of 
magnitude of the best ones. So i ran die top four stilulions 
against the next six test eases. Two of the entries completed 
tliose cases correctly, so I nm those cases against tljc final six 
test cases. I'he second place solution by Ernst Munter was by 
far tht:' faster of liic two, but unfortunately, it did not compute 
the minimal solution for the square of order 37. Wliere Ernst 
calculated a solution dial incUided the following as the 28*^^ row: 

ZS 27 26 Z5 32 31 30 35 36 37 33 34 19 20 17 21 7 8 9 b 6 4 

... Willeke’s entry produced die following .smaller value; 

7.8 77 26 25 32 31 30 35 36 37 33 34 19 20 1/ 21 7 8 9 5 6 3 _ 

I decided not to disqualify solutions diat produced subopdrml 
Latin Sejuares, or that tailed to produce a re.suji in a reasonable time. 
Instead, I ranked solutions by how' many lest cases diey were able 
to cx>fnplete, dien how many they aimpleted correedy, and dien in 
order of increasing execution dme. The prx^lem statement called for 
die use of execaition time only for airrect solutions, but 1 felt that it 
W'js fairest to allow soludoas diat produced a suboptimal result to 
awnixie Ixcsed on liow' well they did. 

Willeke's algorithm lakes advantage of the fact thill squares 
whose size Is a power of two eiui l3e generated with a systemaljc 
jxitlcm of .switching pairs of numbers in row n to tieatc rows a 


power of 2 away fiom row o. He acctimjillslies diis in his FillSquare2 
Routine. Scjuaius o( ckJjct sizes are filled by first filing the laigesf 
,sulis<|uare of size k (k a power of 2), filling the top riglu n-k square 
ojXimally, filling the diagonal, anti then awniilediig ifie squaie by 
irbil and error Ernst's entry makes more efficient use of tnfbrm^ition 
alKHil which digits are foa'ed into use liefore a pjirticiilar a>lumn in 
a given vow l^ecause the digit has alreatJy Ixcn u,scd in suiisequent 
columns. Ernst observes in his entry diat execution time does not 
grow with prolilem size, and tliar pfoblcms of certain sizes (e.g,, 41) 
take much longer to execute rli^m one miglit cxpeit Ixtsed on die 
time reciLiired for .sr^uates of dirncrisioris close in value. 

Tlie first taliie Ix^low lists, for each of die entries submiited, the 
final ranking based on ail test teases completetl, u>ial execution time 
for the first ten cases, the numlxT of test cases aimpleted, die 
numlxtf completed inctiirectly, and die c'ode size, ikm size, and 
language parameters. As usu;d, the number in parendieses after die 
entrant's name is the total numlx^r oi CliaOenge points earned in aQ 
Challenges prior to diLs one. Tlie second and ihiid tables provide die 
rcvsulLs for die remaining twelve test cases. 

Note diat while the top fotir ptisitions in tliis Challenge were 
won by four of our top contestants in the points standing (the 
fifth did not compete), there are a number of new names in die 
list of contestants. Keep trying, folks, I know from per.srmal 
experience that ii takes a while to liecome good at diis, but it is 
possible to knock die leaders from dieir perches. 


GOT BUGS? 

...and you're drowning in paper 
trying to keep track of them? 

You need BusLink! 

• BugLink is s client/server application altowing you 
to connect developers, testers, and support engmeers 
anywhere in the world, 

• Intuitive user interface gives you the information you 
need at a glance. 

• Fully customizable database—add the fields you need 
to each project. 

• Custom TCP/IP protocol minimizes network 
traffic— ideal for dial-up connections. 

• Client appiicattons can operate 'off-line'— allowing 
bug entry and modification even when not connected to 
Che network! 

• Cross platform—set up mixed Macintosh and Windows 
environments in minutes with no additional software 
needed! 

• Try before you buy. Download and try risk free for 
30 days from http://www.pandawavexom/bl/ 

A 5 User License starts at $299; that’s only $60 per person. 

The PandaWflve 

http://www.pandawave.com 
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The products you need, with the prices 
and service you deserve... guaranteed. 


Power Tools for Programmers! 



e War r i pi^R ro 


Sj^otfight 


Spotli^t is Che first Macintosh ^Automatic Debugger". It can 
automattcaily locate run time errors in your code and display 
the offending source code line. Unlike srrnilar tools on other 
platforms Spotlight is easy to use. No source code chariges 
arc necessary for application debugging. SpotJighL can 
automatically check for wild pointers, memory leaks, 
oirerwrites. underwrites. Invalid dereferencing Of handies, and 
even toolbox parameter validity checking spotlight knows 
Macintosh verifying parameters to over 400 toolbox calls. 


$189 


• i ’Wgfc 




BugLink Solo is a database dedicated to collecting and tracking 
problem reports. Ideal for the shareware developer. BugLink 
Solo allows you to distribute witti your software BugLink 
Reporter, which can easily be configured to allow your end users 
to serid smjctured bug reports directly to BugLink Solo. Promt 
users for exactly the foformatkjn you need, send immidiate 
report conformations, customize a new database to each 
project, search for neiaied bugs with a simple query. To kill bugs 
dead, you have to know where to find them. 


$1891 


VOODOO Server is a version control system for software 
developers using Metrowerks Code^rrlor under Mac OS. 
VOODOO Server and the corresponding VOODOO clients (the 
included CodeWarrior VCS plug-tn and fhe VOODOO Admin 
applicaifoni are designed to offer reliable and robust version 
control Features while minimkjng the administrative overhead 
that usually accompanies version control, if you're a single 
programmer or managing a team of developcfs. version control 
tan make or break your project. Do it right, with VOODOO 


C++ Developer's Kit Standars was developed for everyone who, 
even without much knowledge of C+ « larrguaee or software 
developing, wants to know the C++ programming language 
with applications in the OOSE. C+ + Developers Kit explains 
software solutions for C+ + developers, programmers arwl 
C+ + students 




CodeWarrior Professional 5 put everything you need for 
software development at your fingertips: project managetnent 
tools, text and resource editors, source and ciass browsers, 
compilers, linkers, assemblers, and debugger.Release 5 offers 
such features as RAD for Java, faster compile times, local and 
remote application debugging. IDE extensibHity options and 
even tighter C/C+ + compliance. Additionaliy, you can create 
applications for Windows 9SS8/NT and Mac OS 8.x and Mac 
OS X from either host platform, (available in versians hosted on 
Mac or Windows). 


Resofterer is the only sjpported general purpose resouite editor 
for Macintosh. Relied upon by thousands of Mac developers. 
Resofcerer features a wealth of powerful yet easy to-use tools for 
easier, faster, and safor editing of Mac'rnlosh data files and 
resources. Whether you have to parse a picture, debug a data fork, 
design and try out Balloon Help, create a scripting dictionary, 
create anti-aliased icons, design and edit a custom nesounce with 
40.000 fields in iL create C sourte code to run a dialog, or any of 
hundr^ of other resource-felated tasks. ResorcereCs magic will 
quickly save you finie and money. 



Page Channer 2,0 

$139 


Scripter 2.0 

$179 


WebTen 

S349 


FaceSpan 3*0 

TooJsPlus Lite $179 WebSpice 1*000,000 


WebSpice Animations 
mo S89 MkLInux 


PowerKey 

Rebound 


$99 


$89 


$39 


$89 




































PO Box 5200 • Westlake Village, CA • 91359-5200 • Voice: 800/MACDEV-l (800/622-3381) 
Outside us/Canada; 805/494-9797 • Fax: 805/494-9798 • E-mail: orders@devdepot.com 


www.devdepot.com 


Master the Web! 




u i t e' 4 ^2 


Award-winning Fr(;ewiay 2,0 is ssmpty the fastest and easiest way 
to create web pages. Professional web designers worldwide use 
Freeway with its support for CSS and HTML A,0, along with auto 
image slicing, image optimization, multilingual spelt checking, 
HTML Impon. builHn FTP. and an exciting new Actions 
EechnoEogy to create and maintain leading-edge websites - all 
without coding a single line. Freeway ships with a 390-page 
manual (5/5 - Computer Arts Magazine!, Filemaker tutorial, a 
Photo Disc offer with free Images and more! 




NctBarrier offers a Personal Firewall, Anti vandal protection, and 
EnterncL Rltoring Protect your machine from intrusions by Internet 
or AppleTalk. Incorrect passw^ords and individual actions are 
logged, you are alerted to hostile actions, and intruders are easily 
isolated, Internet Filtering allows you to be sure that passwords, 
card numbers, and other sensitive information can never be 
exported from your computer the content itself is filtered before 
any transfer f [Rated 4 mice by Macworld Magazine] 


$199 


WebSTAR Server Suite is a complete set of powerful and easy-to- 
use Ikitemet servers for the Mac OS. Effortlessly serve web pages, 
host email accounts, publish databases, and share hies - all with a 
single application on one Mac! WfebSTAR Server Suite is perfect for 
Internet or intranet serving, single or rnulLipJe sites, small! and 
large businesses - it's power and ease-oFuse saves any organization 
time and money. 




Rjnnel Web is the ultimate web analysis solution for professionals. 
Specifically designed for profiling web site usage and monitorirtg 
customer usage patterns. Funnel Web is Ideal for examining server 
perfonmance and online effectiveness. Funnel Web can analyze log file 
formats from any server, WebSTAR, Weblcn, even Unix or NT hosted 
erverSu Discover tJie most popular pages on your site, track server loads 
*r optimize server performance, profile visitors based on organization, 
domain name, cotmtry. browser, etc. Funnel Web does it all! 


$449 


...and great hardware solutions! 




Add two USB ports to your older Macintosh. Connect up to 
127 devices to the Universal Serial Bus (USB) that is 
Apple's new standard for desktop connectivity. USB mouse 
devices, keyboards, joysticks, game controllers, printers, 
scanners - connect them all to your current computer. 
Installs in minutes! 


Any serious gamer knows the superiority of the flight [oysLicK. But 
until now. Mac users have been hard pressed to find a gaming 
joystick with the kick-butt power and resiliance they need. The 
MaeSurfor USB Joystick fits that gap with features like 4 trigger 
buttons, rapid fire finger trigger, hat control, throttle, two way self 
centering, and complete customization for your game with the 
included Overdrive software 





FutUMftBASi 






























Nmie 

Rank 

Time Completed 

(msec) fjises 

Clases IdO 

Incorrect 

Cases 

Code 

Data 

iiijic 

Ijing 

Wilk'ku Kiiikcn 68) 

1 

4.1 

10 

0 

3976 

8 

C4+ 

Ernst Mtinter (557) 

2 

Z4 

10 

0 

3224 

96 

C++ 

Randy Rortng {116) 

3 

37 

10 

0 

3828 

42 

C++ 

SdKistian Maurer (97) 

4 

524.6 

10 

0 

1.336 

52 

C++ 

Claes WMx^rg 

5 

5271.1 

10 

0 

2596 

T3 

C 

Biorn Davidsson (6) 

6 

141740.7 

10 

0 

2232 

120 

C++ 

Mrekiel Lewis 

7 

155346.4 

10 

0 

5112 

207 

C++ 

Paul Russell 

8 

1436033.6 

10 

I) 

1660 

H 

C 

Joiiny Taylor (2^) 

9 

4.5 

9 

0 

57S8 

156 

C 

Derek IjedlieEier (4) 

in 

19!?,.5 

10 

1 

1.3088 

312 

C++ 

S. S. (withdrawn) 

11 

2.4 

7 

n 

592 

H 

C++ 


Name 

Rank 

Time Completed 

Incorrect 






(m^^ec) 

Cases 

Cases 






Cases 11 16 






Rrnsf Muracr 


6.1 

6 

0 




Willeke Rkken 


1968.2 

6 

n 




Randy Boring 


40604.8 

3 

n 




Sdiasiian Maurer 


N/A 

0 

0 





Name 

Rank ITine Conipleted 

Incorrect 


(msec) Cases 

Cases 


Ceases 17-22 


Ernst Mumer 

3200253.1 6 

1 

Willckc Kii'ki'n 

13013297.2 6 

0 



Top Com'ESiANTS 

IJstcd here are the 'lop Contestants for the Programmer’s 
Challenge^ including everyone who has aeeumuiated 10 or more 
points during tlie past two years. The ntiml^ers below include 
points awarded over tlie 24 nio.st recent contests, including 
points earned by lids month's entrants. 


Rank 

Name Points 

Rank 

Name 1 

Pt)ints 

1. 

Municq EmsL 

215 

10. 

Downs, Andrew 

12 

2. 

ijaxton, Tom 

139 

IL 

Jones, DennivS 

12 

3. 

iVIaiirer, Seba.stian 

91 

12. 

Halt, Alan 

11 

4. 

Ritiken, Willeke 

61 

1.3. 

Duga, Brady 

To 

5, 

Boring, Randy 

50 

14, 

Hewelt, Kevin 

10 

6. 

HeitiiccKk, JG 

43 

15. 

Murphy, ACC 


7, 

Sheareq Rob 

43 

16. 

Selengut, Jared 

10 

8. 

Tayloq Jonatlian 

24 

17. 

Siroui, Joe 

10 

9. 

Brown, Pat 

20 





There are three ways to cam points: (1) scoring in the top 
5 of any Challenge, (2) lieing the first person to find a Intg in a 
published winning solution or, 0) being the first person to 
suggest a Challenge that I use. The points yt>u ean win are: 


1st place 

20 points 

2nd place 

10 polnls 

3rd place 

7 points 

4th place 

4 points 

5lJi place 

2 points 

finding bug 

2 points 

suggesting Challenge 

2 points 


Here is Willeke’s winning Latin Squares solution: 

LatinSquaresxp 
Copyriglit © 2000 
WeOeke Rieken 

r 

Afier g^iieraiing several squares a paltem cmcri^ed. 

If n is even, every second row can be geneniied by 
switdiinj* pairs of numlwr.s of the njiv above. 

Tf n casi be divided by 4, every- tliird and foartli 
row can be generated by switching squares of 2 by 2 
oniTibtTs of the 2 mw5 above. 

Example; n = 12 is generated by generating 

ri = 3 and replacing every LiuniLver by a square with 

n^: 4. 

Ollier n's are generated by generating the biggest 
power of n that fits in the .square and generating 
a stfuare of n - 2''x at the top right.This square can 
be repeated to the bottom left till the first square ends, 
the numbers in the firat column arc in ascending order, 
the diagonal from lop rigih to boiiom left is filled witli n. 

Example; n 7 

1234567 

2143675 

3412756 

4567HXX 

5x7XXXX 

6/xxxxx 

7XXXXXX 

ITie remaining numbers are generaLed by trial and ciror. 


^include "LatlnSquaros.b" 


liLISqLiarc2 

static void FiilSquarei(long n, short *latinSquare, 

long thnfiljiL. 

long thfiStartRow, long theStartCol» 
long tbeStartVal, long tbeNrOfRovjsJ 
// n is a power of 2. fill the first row with a.scending numbers 
// and switch them around to generate the other nows. 

1 

short *aFrotnl, *aToi, *aFroiii2. *aTo2: 
long aValue = tlieStartVal + 1, aRowsDone, aHultiple; 
short 'aStartSquare = latinSquara + CtheStartRow * tv) + 
thsStartGol; 

7/ fili first rtw 

aFconl = aStartSquare: 

for (long aCol = 0: aCol < theMm; aCol'H-) 

I 

'aFrcunl = a Value; 
aValue++; 
aFroml++: 

I 

aRovfsfione ^ 1; 
aMultiplfi = 1; 

wbiln (aRowsDone < tboNrOfRowti) 

[ 

for (lung aRow = Or aRow < aMultiple; aHow++) 

I 

if (aRow >= thaNrOfRows) 
breaRr 

for (long anOffaet = Q; anOffscT < Thr*Dini; anOffsat += 
CaKiiItiple * 2)) 
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t 


sFromZ “ aStartSquare + CaRow * n) + anOffset; 

^Fronl " aFrfl 3 n 2 ^ aMultiple^ 

aTol aStariSquare + (faKultJple + aRo«) * n) ^ anOffsat; 
3 To 2 = bToI + ^Multiple; 

for (long aCol “ 0: aCol < aKuItlple; aCol++J 

( 

*aTol * “aFroml: 

aFromi+t; 

flTol++; 

*aTo2 - *aFroiR2i 

aFroiii2++; 

aTo 2 ++; 

J 



aRowEfDorve aMultiple; 
^Multiple <<“ i: 

I 

1 


CnpySquarc 

static inline void CbpySquaretlong n. short *theFroiii+ shori *LbeTo, 

long theDim) 

I 

// copy a s(|uarr of stze thcDim Enim thcFnim to thcTa 
short 'aFrom, *aTo: 

for (long aRov “ 0 ; aKow < theDlinr aaow++) 

! 

aFrom • theFrom + (alow * n ); 
aTo “ theTo + (aRov ‘ n); 
for (long a Col ^ 0 ; a Col < theDio: aCol++J 
( 

'aTo = 'aFrom; 
aF rotii++: 
aTo++; 


Compktdiquan: 

static void CcanpleteSquarenong n. short *lstinSquare, 
long theBia* long theSubOliti* 
long theStartRow, long theStartCol, 
long theStartVal) 

// fill rtmaming numbcoi by trbl and emir 

( 

short ‘aStartSquare " latinSquara f 

f(thoStartRow * n) Ki theSubBint) i 
UhcStartCol « theSubDiw) i 
short 'aValInRow “ new short [theDin]; 
short *a^aHnCol “ new short [theDiii * theDimj : 
short “aTofloFilled = new short [theDim * theDimJ : 
long aRov, aCol, aValua, aSubDimvalue: 
short 

aSubDlmvalue - 1 << thoSubnim; 

// (ill IcB row mid diagonal 

p “ aStartSquare + [(n theDlm 2) <C thcSubBlm) j 
q = aStartSquare + [n « theSubDini) i 
for {aCol = 1; aCol < theDim: aCoi++] 
i 

CopySqLjare(n» aStartSqnare 4 ((theDim - 1) « theSubDim) * 
p, aSuhDiitivalue); 
p += ((n 1) CC theSubBifit); 

CopySquare{n, aStartSquare'^ (aCql « theSubDlm)« 
aSubDimvalue)I 
q +- in « theSubOiin): 

I 

// which numbent arc ased and which numfKfik liavc to be Hlkd in 
for (aCol ^ Oj aCol < tbeDin * tboBiSj; aCol’H-) 

I 

aVailnColtaCol] = 0; 
aToBeFiiled[aCoij * h 

I 

for CaRow ^ 0: aRow < theOim; aRow++) 


1 

I 


CantFillRow 

static short CantFillRow(tong theDim* short 'theValInCol* 

short *theVslInRow* long theCol, 
long *theValue) 

// dicck Lf there arc nura lKts that can ' t be placed and if there 
// arc cnoygli colunms for the bigger numl>crs 
I 

long flGreaterPlaceflileeded “ 0; 
short aValBK " Or 

for (long i ^ *theValne 4 Ir i < theDijn: i++) 

If (ItheVallnRowtlj) 

I 

aCreaterFIacesNeeded++; 
aValOK = Or 

for (long j - theCoI +1: j ( theOin; j++) 
if (ItheVallnColtj * theDim + il) 

I 

aVslOK » 1: 
break[ 

I 

If (JaValOK) 


1 


‘theVaJue = 1 * U 
return 1 : 


for (long J ” theCol + Ir J < theDim; j++) 


aValOK = 0; 

for (long i = 'theValue 
If (MtheValInRowliJ I 
1 


1: i C theOlBi: 
theVallnCol[j ' 


i++} 

theDtB + 


il)) 


aValOK - 1; 
break: 
t 

if (aValOX) 

aGreaterPlacespeeded : 

1 

If (aCreaterFlacesMeeded > 0 ) 
return 1: 
return 0; 


p " aStartSquare i ((aRow ' n) « theSubDim): 
for (nCol “ 0; aCol < theDim; aColH) 
f 

if ('p) 

I 

aValue “ aCol * theDim 'f 

(((*p ' 1) » theSubDiai) theStartVall: 
aVflllnColfaValue] = 1; 
aTnBeFiUedfaValuel = 0; 

1 

p USubDimvalue)r 

I 

1 

// which numbeis arc in ibis row 
for (aVaiue 0: aVaiue < theDim: aValue-H-) 
sVallnRowfaValuel = Or 
aVnlue = 0: 
aRow 1: 
aCoi “ 0 * 

p ^ aStartSquare + [n « theSubDin); 
while (1) 

I 

// find next place to ve OUed 
while {*p) 

i 

aValInRowT((’*p - 1) >> theSubDim) * theStartValJ “ 1; 
aCol++; 

p += (aSubDimvalue): 
if taCol >- theDim) 
i 

aCol = 0; 
aRovt+: 

p = aStartSquare + C(aRov * n) « tbeSubBim): 
for (aVelue = 0; aValue < theDim: aVaiue++) 
aVslInRowfaValue] - Or 
aValue = 0: 


I 

// find next posibic value 
while ((aValue < theDim) && 

taValInCollaCoi “ theDim + aValue] )| 
aValInRow[aVaiue] 11 

CantFlllRow{theDim* aVaiInCol* aValloRow* 
aCol* &aValue)]] 
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jiVfl1uc++: 

If (aValiic i ihullim) 

I 

// plate value 

aVallnCoitaGoi ' theDim + aValue] = 1: 
aValliRowUValuel = 1: 

Copy5quare(n« aStariSquarG 4 UValuc « theSubOia). 
p, aSubfJiinvaluc) I 


// rvcxi eniiimn 
aCol++: 

p +“ (aSubDirovaiue): 
if (aCol >- thGOiM) 

I 

// nej^l niw 
aRoii^+4j 

if (aRow < th^nin) 

I 

p - aStartSquare + ((aRov " n) C< theSubDlm}: 
for (aValue ^ 0: aVaiue < thentn; aValiieli) 
aVailnRowlaValue] = Oi 
for laCol “ 0: aCol < theDim: aCo1++) 

t 

aVallnHowtaValuel = 0: 

IT {-pj 

aValIfiRuw[tC‘p 1) » tiieStibmjfi) - tbeStartVal) - li 
p taSubDimvaluG); 

1 

aCoi - 0; 

p * aStartSquarG + ((aRow ‘ i>) « theSubnini): 

f 

else 

I 

teluttj; 


1 

aValue - 0: 

1 

else 

I 

// undiJ 

aCoI“! 

p *= {aSubDlmvalue): 

aVaiue * {(*p 1) theSubDici) ihpfitariVal: 

while (aCol 0 fnk taToBeFiJledfaCol * thoDlm + iiValuelJ 

t 

a Col-: 

If (aCoI >= 0} 

[ 

P (a!iubl>iiivalue): 

aValue - (Cp - 1) » theSuhDim) - theStartVal: 

I 

I 

if (aCol < 

I 

aHow : 

p “ aStur(Square + 

(((aKow * o) + theBira • 1) « iheSubDlra): 
aCul = rheDiat ^ 1: 

tor taValue 0: aValue < theDiro: a¥alHe4+J 
aVallnftowlaValuel - I: 

I 

aVflliiG “ ((’p I) » IheSubDlmJ theStartVal; 

‘p - 0: 

EiVfil I riCul UiCo) ‘ theDitit + aValue] =0: 

uValliiKowiaVaiuel ^ 0: 

aV3lue++; 

I 

t 

deletefl aVslInCol: 
deletefl aVaTTnRoiifj 
delete[] aToRt'F 111 ud: 

1 


RlLS(|uun’ 

atatic void FillSquareClong n, short MailuSquare* 
long theBim, long theSubnini, 
long fheStariRow* long tbeSurtCol,. 
long 1 hnSlortVal, long rheMrOfRovrs) 

// Dll I'itin 

// if n can be diviikti by a power of 2. 

// thcSiibDini is 2^x, ihcDinr is n/<2*x) 


I 

If ItheDim =“ 1) // n is a pm tr i>f 2 

FillSquare2tn, latlnSquarG» 1 « theSubDln, 

LheSLariRow « theSubUin. theStartCol « tbeSubDim, 
iheStartVal C< theSubUiBi, theHrOfRows « theSubDim): 

else 

I 

long aMaxPowerl* aKrOfRows* aStartCoK aStarlRow: 
short *aSrartSquare “ latlnSquare + 

((tbeStariRow " ti) « theSubDim) + 
(theStartCol « theSubDiro): 

ftHaxPowcr2 = I: 

while (aHaxPower2 <= theDitn) aMaxPowGr2 <<= 1; 
uHaxPowerZ »=" 1; 

// DJI Ldp JcA of Uk sqiwrc with a squaa* with n = 2^sMaxFover2 
FillSqiiare2(n, latlnSquere. aMaxPower2 « theSubDlm, 

theStartRow « theSubDim, theStsrtCol « ihcSubDlm, 
theStarWal « theSubHim, aHaxPawer2 « theSubDim): 
nWrOfRows ' thcDlm aHaxPuwer2; 

if (aNHlfRows > theNtOfRowe) aNrOfRowa " theSrOfRowst 
// fill Uip right of the sqimrt with a squ;iTV with n = ihcDim *2'^uMaxPtJwct2 
FiilSquare(n, latinSquate, theDim ' aMaxFower2* theSubDimp 
tbeStartRow, thaStartCal + aMaxPower?., 
tbeStartVal ^ aMaxPowerS. aNrOfRows): 
y/ copy the square from the top righi along itw: diagonal hj the boiiofii left 
aStartCol aWaxPower2 aNrOfRows: 
aStartRow afirBIRuwa: 

will It* (aStartCol >= 0 hB aStartRow < theNrOfRovs) 

I 

If (aStartRotf 4 ahrOfRows > theNrOfRows) 
aNrOfRowE = tbefIrOfRowE ^ aStartRnw: 
if C^iNrOfRows ) aSrnrtCol BB aStartCol > 0) 
aNrOfHowfl ” aSt a rt Cq11 

for (long aRow “ 0; aHow < (aNrOfRows « tbeSubDimJ: aRovH-J 
1 

short 'aFrora - aStartSqiiare f (aRow * n) 1 
CaMaxPower2 << theSubDlm); 
short *aTt> = aStaftSquare » 

{((aStartRow <C thnSubPIni) + uRaw) * rr) + 
EaSiartCol << IhL'SubDlmJ; 

for (long aCol = 0: a Col < ((theDim aJiaxFowery) << 
iheSubniEc): aCol4+J 

( 

‘aTo - “aFrom; 
aFroni++: 
aT o H : 

I 

for (long aCol ^ ((nSiartCkil 4 (thelUn - aMaxPower^)) « 
LbeSubUia): aCol < (aHax?ower2 « tbeSubDim); aCoI++J 


I 


*aTo - C: 

aTe4+: 

I 

1 

aStartCol (thenia aMaxPower^): 

aStartlow (thenim qHnxPower2h 

I 

// gL-ntxjtc The renoning niimlx is 

CompleteSquareCn. latinSquare, theDim- theSubDim, 

theStartRow, theStartCol, theStartVall: 


Utinkptetas 

void batiiiSqiJBres C 

nlmrt n - t dimension of die lurin s{|ujirt^ lo Ix' gcncmitd 7 
idiot t * lutinSquare t m: 1 lidinSquiirtic + r'lif lo H|iwr\- vhIuc niw r.col € 7 
) I 

short 'p - latinSquare; 
long aSubDlio ^ 0: 
yy init 

for (long 1 "" 0: I < n * n: 1++* p++) 

•p - 0: 

// 4:an n he dividtxl bv a pomt of I 

while (Kn * (r« aSubDlJi))) aSubDi«++: 

FlllSquaretn, latinSquare. n » aSubDim. aSubBlin- 
0. 0. 0, n >> aSubDim): 


1 


K 
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Continued from page 4 

Once again. Wel‘>ObfC!(;ts delivers ilie giKKis. I Inlike half of 
the application serx'ers that TediMetrix studied, WebOhjects 
successfully performed under all workloads. 'lliLs coupletl with 
it excellent perfonuance and scalability clearly show that 
Wel>C)bjecis is able to deliver ihe gtK>ds under all ctjndiiions. 

BI'YOND Hygifnf 

Performance, scakibilitVt and reliabillLy are l>asic ’‘hygiene''. 
WiilioLil them, you don'i lia%'e a chance of competing, but they 
don't make for a compelling Uk>1 

So, how clc>es WebC >bjects move lx:yontl hygienei' Based on 
the siinie f>bject-oriented foundations as OjX'nStep and Ccxoa, 
WeliOhjecis, is a highly prmluctive development environnieni. If 
you arc^ impressed by the developer pnKJuciivity delivered by 
OpenStep or Cocoa, you already know- the develf)per 
producrivity delivered by WelK)hjeets, If you don't then you ow'e 
it to yourseir to expei tence it. 

Wel>C)hjeas also iodndes a powerful collection of ckusses. 
Enterprise Obfetas Pntmework {EOD, that gives WebCJbjecis’ 
applicaii<ms easy access to new and legacy databases. For 
exainf>te, die HOP features of WebObjecLs allowed the IS folks in 
the olTice of the Sec retary c^f Defeitse to build an appikation that 
tied togelher numerous legacy systems - many ntnaing on older 
mainframes - into a single application mih a clean and unified 
user imertace. When fmikling its Personal Wealth application, 
Standard ^ Poors ran into similar issues w'hen trying to interface 
with existing daiabases tram varit>us vendors. Agaiti, EOF 
allowcxi Standard ik Poors to build a single application that 
prestmiecl a clean and unific'd human interface to users. In I'aci, 
mucli of the iK>wer of Web(3l>jecis comes from EOF. Without it, 
WebObjects would not lx- as powoTfui a tool as it is. 

If it is so gcKMt why isn’t everyone using it? 

Given what you have learned about WebObjects, you are 
probably a.sking yourself, “If it is so good, whal isn't 
everyone using it?" 

Tile answer in part, is Apple dcxsn'i advertise WebObjects. 
But if we think tfiat Apple should advertise WebObjeds, we 
have to ask oui^selvc^, what w^oukl lx* tlx* impad? How' would 
an ad for WebObjects from Apple lx receivcxl by the average 
reader of Tlie Industry Stanckird or PC Week? Proha lily with a 
high degree of sket>ticisni. Given Apple's track rec:ord in the 
enteiprise, it prabal>ly doesn't make a lot of sense lor Apple to 
thrown clollars into advertising for WeliObjects. Rather, they need 
to fcxiis on making siia* that the decision-makers exmsidering a 
[iroject knew about W'elX3bjeds and iLs power. 

^io, how do we gel Wel>Objecls in front of decision-makers 
Willi (Tediuibility? First, we need to fmve pow^erful sucres,s stories 
to which w'e can point. With over iius,sion critical 

applications already built using WeliOlijects from many high 
profile companies, Aj>pie has a rich field of c^indicbtes for 
success stories. And Apple has done an excellent job of 
collecting WeliObjects success stories from this field. II you are 
interestcxl you can find them at Apple's Wel>(3bjeci.s wel) site 
(,see Links of Interest below' for the CRL). 


WebObjects, like other apfdkation servers, is going to be 
sold one-on-one. Be it by Apple sales rep.s or Apple partners, 
die sales of WebObjects svill happen in <me on one settings. 
It Ls wlien someone, armed witli the success stories that 
Apple is producing, can talk Uj someone looking to build a 
web apfilicaiioii, that the sale.s of WebOhjecis wall )ia[>]xm. 
Advertising wxm't drive ii in any meaningful way. So, maybe 
Apple’s steahh marketing makes sense. If advertising isn't 
going to drive sales, why waste the money? Maybe .Apple 
isn't as dense as many of us thought! 

Want to Learn more? 

If reading about the power and advantages of 
WebObjects above has you interested in learning more, there 
are a lot of resources available to you. 

First and foremost, you can start off [>y rcaditig Sam 
Krishna and Patrick Taylor's first article in their series on 
develtrping with WebObjects, "‘Fvetyone meet WebGhjects. 
WebObjects tneci everyone.” starting on page <HDlTOR 
PLFASF [^N'I'ER> in this issue. If you are serious alxHit learning 
more about or using WebObjects, make sure you read their 
entire series as it unfolds over the course of the next year. 

Surprisingly enough. Apple has a large amount of 
material available For you on their web site. If you are 
looking to exi>lore things from top to Ixatom, then clieck out 
the Apple WebOhjecis home page (see Links of hiteresl 
below for the URL), If y<ni are looking for a balanced, third- 
party perspective on WebObjects check out ilte IDC 
WebObjects White Paper posted on Apple's web site (see 
Links Mentioned Ix'low for the ITRL). 

Links of Intfrf.st 

• jakoli Nielsen's Alen Box 

www.useit.com/alertbox 

• 'I'uchMetrix Research 

www.lechmetrix.com 

• 'FeGiMetrix Application Sender l^erfoniiance results, 1 to 10 
simulfaneous u.sers 

www.techmetfiK.com/lab/benchcenter/appserverbench-bench4.shlml 

• ‘I'echMetrix Application Server Performance results, 25 to 250 
simultaneous usei's 

www.techmetrix.com/lab/benchcenter/appsefverbench-bench5.shtml 

• TechMeirix Api^lication Rcdiability During Testing 
www.techmetrix.com/lab/benchcenter/appsefverbench-bench3.shtml 

• Wel>0[>jecLs at Afitilc 
vvww.apple.o:]m/webobjecTs 

• IDC Wel>Objecis White Pa[X-r 

www.apple.com/webobjects/whltepaper/index.html Kj 
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By Neil Mayheuj, Caly^ary, AB 


Iterating For Profit and Pleasure 


Using iterators to tap into 
the power of the Standard 
Template Library 


A Bravt. Nfw world 

Iterators art* not a new tclea, Ihese 
lightweight objects j^rovidc a convenient 
way to step through the elenicnts of a 
collection. Likewise, the Standard 
Template Libmn^ has l>een around for a 
while now, although many jx:of>lc have 
still ii) explore its depths. Iterators are a 
fundamental part of S'lL, and an 
understanding of their role is vital for 
effective use of tlie Library. .Many of lite 
data structures tliat we work with every 
day are 'virtual' collcctit>ns, anti l>y writing 
our own S'IL-com)'jatible iteiiitoi-s for them 
we can make use of many powerful 
algorithms from STL. 

As an example of custom iterators, 
this third and final article presents a set of 
cla,sses that iterate ihnnigh the items in a 
Mat:OS folder. 'Ibese mesh w itii algoriilincs 
from STL to produt*e an application Uiat 
checks the System Folder for additions and 
cfianges to its extensions and control 
patiels since the last time tlie application 
was run. 

Developjers already familiar wiiii STI. 
and its use of iterators may wish to skip 
to the first implementation section, 
“Walking a Folder", 


In search of elegance 

In llie most general sease, an iterator Ls an object that 
records an index inu> a collection of other objects, and allows 
those objects to be retrieved for pRK:esstng. Of course, it must 
also be possible to advance the index forwart.ls, and possibly 
backwards, to reference other members of tlie collection. These 
actions are invoked by calling mctfiods of the iterator object. 

An example of the effective use of iterators is in the reading 
of ain-lengili encoded pixel data. It Is possti>le to define an 
iterator tliat presents the iltusiim of a retiangular array of pixels, 
whereas this array is a virtual collection tliat is computed on the 
lly from tlie run-length-encoded data. Tile iterator's internal 
storage (Instance variables) reccird a pointer to the cuiTeni run 
and a coimt of tlte numlier of pixels still to lx: read from that run. 

There are of course many ways to design a set of 
methods for an iterator. For example, nextt) and previousO 
methods can be used for advancing forwards and backwards 
ihrougii the assexiated collection, and alEndO can be used to 
lest for the availability of further elements. Unfortunately, a 
lack of standards in this area is a great hindrance to code 
reuse. Code that uses iterators from a given source cannot 
easily fie adapted to use iterators from a different source, 
Likew'ise, programmers often find it easier to develop their 
tiwn, simple-minded solutions to a problem than learn how¬ 
to use yet another -set of iterator conventions. 

Yet C has some very pow^erful iierators of its own that 
many other languages lack: pointers, Tliesc are iterators in 
the sense that ijjey step through a colleetion (an array or 
linked-lisO without additional support. There is no need for a 
.separate reference to a collection that must lie u.sed with a 
subscripting operation when retrieving elements. Countless 
algorithms owe their elegance to the use of pointers instead 
of arrays and subscripts. Learning to use pointers effectively 
is therefore one of the key requirements for bectiming a 
skilled C programmer 


Neil May hew works for Wycliffe Bible Translators, a noTVpRjfit oiganizalion dedicated to traaslating the Biljle for die w(.jrld;s 
400 millicm pciiple that do not have it in their rwn language. Neil started prognimming in C in 1983, ant! graduated to the Mac 
in 1989. When he's not at his Mac or trying to iKrai his kids at video games y(Hi miglii find him flying a stunt kite if it's windy, 
or throwing a boomerang if il'.s not. Write to him at NeiLMayliew@WyclilTe.org. 
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A stands rdized approach 

Since C already has a wefl-eslal>lished paradigm lor the use 
of iterators, ii makes .sense to standardize on this mcxiel in C++. 
We disciKssed smart pointers in an earlier article. These are 
objects tliat have the syntax and semantics of a [pointer, through 
overk)acling the *, -> and ++ operators. A standarciized iterator is 
therefore a special case of a smart pointer 

The advantage of this approach is dial ctxle may l>e written 
in a style that is ver>' similar to die one that would lie iisetl with 
raw pt>inters. TliLs makes the code easy to write and easy to 
understand, and yet considerable sophisdcaiion may lie present 
‘under the .surface' within the iterators themselves. 'I here need 
not be any hidden pitfalls, however: if the semantics of the 
iterator arc clearly defined, anti consisteni widi the usual 
Ix'havior of pointers, then client ctxie will work as expected. 

In fatt, code u.sing smart pointers for iterators may often lx 
safer than equivalent code using raw pointers. For example, a 
siuail jK>inter Is usually aipable of perfonning Ixiunds checking, 
in a debug build at least. Or, awkward and error-prone pointer 
manipulatioas can i^e taken rare of in one place, inside die iterator, 
and client c<xle is free from having to wony about such details. 

Mastering new idianis 

A sulxk cliaracteristic of the smart-pointer approach to 
iterators is that they will lx parsed around by value, sint^* this is 
h(w regular pointers are United. 'Ihese iterators tlierefore need to 
lie small usually just 4 or 8 bytes; any bigger ihtm this and client 
code would have to be aw^are of the need for efficient handling. 

Sophi.stk:ated behavior, liowever, doesn't necessiirily reejuia^ 
large amounts of storage. An itemior for a linked list need only 
occupy four bytes, and yet die dereference operator can return 
a reference to die list element rather than to the ntxle dial 
contains it. Likewise, the increment operators cun follow the link 
to the next ncxle. 

This standardization allows a linked list to be pnxressed just 
as if ii were an array. For example, the following coastaiction is 
idiomatic for all standardized iterators: 

for (Iterator p = begin: p end: up) 

I 

fEjtpressions using *p ,d 

I 

Note dial the loop increment uses ++p and not p++. It Is 
impoHant to understand the reason lor iliis, and to remember 
to do likewi.se in your code. Recall that the post-incrcmcni 
operator returns a copy of the iterator or pointer as it was 
Ixfore the increment. This behavior is not needed in this 
context, since the value Is not used anyway. However, w^hen die 
item Ixing incremented is a user-defined objeel rather than a 
pointer, the compiler is not entitled to substitute a pre¬ 
increment rather ilian a post-increment, since the two methods 
may have different side effects. Ihere is therefore no way to 
avoid creating a redundant cf>py of the iterator object each time 
around the kxip. 

Note that the loop test uses !“ and not Again, there 
is a gcxxl reason for this. To the case of a linked list, die < 


fiperator is verj' difficult to implement, and not very useful eiilvcr. 
Since tliere is no compelling rea.s«)n to use <, even for an array, 
it is Ixtter to write all loops using !=. 

These conventions enalile client code to remain unchanged 
even wlicn the collection'.s underlying representation is changed, 
for example from an array to a lisL As well as easing the 
maintenance burden, this has the much more general advantage 
that template functions can be written that work with a wide 
range of representation types. Tlie etxle can lie written once, as 
a template, and reused with any collection that uses standardized 
iterators as an interhice, 'these generic functions arc usually 
referred to as algorithms. 

Algorithms + Containers = Programs 

Naturally, many of these algorithms are well-understocxl 
examples from computer science, such as sorting and searching. 
Now^ that we have a mechanism for writing these in a txirnplelely 
generic way, it makes sense to have a standard libraiy of 
templates that can l>e re-used in almost any situation. Hence tlie 
name Standard Template librrrry or STL 

Just as die algorithms are chissk examples, so are many of 
the collection types, such as linked lists and dynamically 
growing arrays. The Libraiy' therefore also includes a 
represeniadve selection of collection rypes. Tliese are usually 
referred to as container, and ifiey avoid die neetl for endless re- 
implementations of common container types. The icmplate 
mec hanism is still flexible enough to allow a wide variation in 
die behavior tliat can result From use of the tem[>iate. 

I'he magic ingredient that enables algorithms and 
containers to work well together is the standardized iterator. All 
of the containers have beginO and endO methods that return 
iterator values for the start and end of the collection, and all of 
the algorithms ex[>ett collections to be represented by two 
sLidi values. 

An algorithm Eypirally has the following form: 

tempIateCclass lL> 
fiome.alxorithmtlt begin. It end) 

I 

For (It p = begin: p !” end; ++p) 

I 

1 

I 

U is called like this: 

nome algorithm(container.begln(), container.end()); 

Neither the algorithms nor the containers are closed sets: the 
user can very ea.sily add new algoridims and containers, and 
provided stand^irdized iterators are involved these wall integrate 
seamles^sly w'ith the rest of the Ul>rary. Wc will see an exampie 
of this shortly. 

Smart gjue 

Iterators are the glue tliat holds algoritlims and containers 
together to make programs. Tlie Standard Template Library 
elevates die use (jf iterators almost to the level of an art form. 
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For i'XiJmple, many algoriliims pTKxiiice a new collection as 
their output. They expect to write this out[)ut usin^ :rn iterator. 
Such iterators are culled outlet iierators, to distinguish liiem 
from the read-only inpul ikrakn's ihat provide the input data. 

However, it may not be known in advance exactly how 
niiiny elements will lx* produced in the output This shouldn't 
lx* a problem with a dynaiiiically sized collection, except that tlte 
eletiienls are Ix^ing ap|X"nded to the coHcciion iLsing an iterator, 
llie iterator has to lx smart enough to call ilic ixiniainer's 
append method wliencver iite algorithm w rites a value titrtmgh 
the dereferenced iterator. Such an iieraior is allied a buck 
inserter, and it works l>y some nither clever sleighi of hand that 
incliide.s overloading the = nperator. Needless to stiy, this is 
implemented by yet another template in the Libnityc 

.Another example of the creative use of iterators is tlie set of 
sire(4m iterators that is providetl by the Librtiiy, Tliese iienik>rs 
enable the successive reading or wTiiing of ol>jects via iostreatns, 
so tliai inienneduire steerage is not rccjuired when passing the 
data to or from an uigorilhm. 

Not all iterators liave to be so smjMT howeven Every' 
algoritlim in the library' will work happily wiili niw pointers as 
the iterators, provided the imderiying raw^ array is latge enough 
to liold any outi>ut that may lx genemtexf U is a fundamenial 
principle of the libraiy tlial iterators and |X>iliters must lie 
C( Hiipletely inlere ha ngeal >le. 

Committing to the Standard 

Many lihniries iiave been liased on exct^llent theoretical 
principles, and some have been promoted as universal 
.standards, Htyw'ever. tliai dcjcsn i main tliey have alw'uys Ixxn 
universally accepted, 

STL is exceptionally well designed, and has been 
rliorotighly tested over a nnmlxr of years. It is elTideni, 
comprehensive, and ponable. Notiiing in STL preclude^s it fix an 
being a gootl diizen w'ithin the MacOS. Altliougli iostreams are 
supported as an option in several areas, they arc by no means 
ret|uired, and most of tlie functionality is purely computational. 

Code that makes extensive use of STL over more 
homegrow'n solutions usually fias much greater clarity, 
esfxcially if die reader Ii:ls a general familiarity with STL A lot 
of the clarity results from the fact Uuil loops arc* largely 
eliminaled from user-code, since mo,st of the kxjjxng lakes pfaxx 
inside the algorithms. User-code is more parallel in nature, being 
expie.sserl in terms n\ operations on entire collections. Also, 
groups of calls to standard algorithnis are usually inucli arsierto 
read dian a series of cusUan loops. 

As more and more devekjjxt's Ixxome aw^are of the benefits 
of S11. uiid commit to using it in their work, the value of STL 
can only increase. It is increasingly likely that another develo|xr 
.studying ones axle will lx comforlahle with its style and 
.structure, 'flie c|uality of S1L implementations conriniies to 
improve, and new algorilhms and collections are becoming 
availal>le all the time, tdlen for free via the web, 

just as the fund ions from the standard C libnuy^ have 
Ixxome an integral part of ihe language over the years, die 


algo fit It ms and containers from STL are becoming an mtegral 
part of C++. This is not surprising, given that Bjarne Siroustnip, 
die creator of C++, has been very active in the develojimeot of 
die Library. For a wdiilc, the language and the Library developed 
in parallel, as the template capabilities of l!ie language w'ere 
pLislied CO die limit and Ixyonrl. 

Fortunately, the language and the libniry are now static, 
having at last been adopted as an ISO standard. It is sate to 
assume dial any mixlern C++ implementation will have a solid 
implementation of tiie Standard I.ibrary, which is a sujxrsei of 
STL. Ctxle using SlI should therefore be portable to any 
platform that ha.s a mextern C++ compiler, 

WA!.K1^G a FOLDiiK 

Theory is of little value unless it is used. The combination 
of standardized ilcralors and STL aJgoridims can lx very 
effective in a MacOS selling. Although there is always anodier 
way to skin any rat, an S'll-based approach is usually rapid in 
its develofiment and efTictent In its implementadon. 

Alt operating sysicms fiave facilities for itenuing ihrougli 
every file in a folder. I'he MacOS is no exception, although the 
.sole medKxJ for doing it, using PBGetCatlnl'o, can lx rather 
teditJirs. It w'tjuld lx nice to develop an iterator facility lhat gives 
I Ids operation a simple, higii-level interface, llie result would lx 
a virtual cxjI lection, sini'e the elements need not all exist at once 
as objects in menujry. although they do exist as a collection of 
‘objects' on disk. 

Simple interface, subtle design 

An interesting design issue concerns the exact nature of tlie 
information that is returned. Tlx obvious answer might seem to 
lx‘ an FSSpcc, hut unfortunately this d(xsn'l allow one to 
distinguish Ixtw'een files and folders. It would be possible to 
skip the folders, but this w'ould ixeveni a recursive descent of 
iin eiilire folder hier^irchy. At the other extreme, the entire 
contents of PBGetCaMnlo's parameter block could lx returned, 
but this would lx cumbersome and ineftlcient in most c'ases. 
Ihe be.st compromise seems to be to rectum just the most 
rfettuentiy-u.sed file and dircxiory attributes, representing this 
using a subclass of t'SSpec so that it am be list'd as a parameter 
It* any tT tlie MacOS APIs that expea this datatyfxc 

Another design issue conceras storage management. This 
is almost always an Lssue in C++, and many people feel that 
this is an unwek'ome complication of tlie langULige. However, 
it also allows great llexibiliry in the implementation tradesiffs 
I flat can be made. Other languages force one to store all non- 
scalar data in dynamically alkxaLeci heap storage, which 
introduces signifiaint compurational overhead. In conimst, C++ 
allows objects to be returned by value, niiher tlian by a puintcr 
t?r a rcTerence. This eliminates the problem of object lifetimes, 
which would otherwise have Co l>e handled l>y reference 
counting or garbage collection. 

It Is often thought that retum-tjy-valiie is also expensive 
compuuitionally, lx*t'aiise of the amount of data tiuii has to lx 
a)pied, but tliis need not lx so. When client code calls a 
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function that returns an object, a hidden argument \s passed that 
contains a |X)inter to a block of uninitialized storage that will 
hold the returned object. In effect, tite called funaion copies 
the return value into tliLs storage using the appropriate copy- 
constructor, and the client code uses a copy-consLmctor or 
assignment operator to move the ol:)ject to another location. 
Twt) desiruaor calls are also involved, of course, to clean up 
the intermediate values. 

However, if the return statement in the called funaitm is itself 
a constructor calf niosi compilers know to optimize this as a 
direct construction into the space that was reserved by the caller 
and passed as die hidden aigumenL If in addition the client cxkIc 
u,scs the function call as the initializer for a named variable of lire 
same tyfx.^ as the return value, the compiler will optimize this by 
passing the address of the uninitialized variable as the hidden 
argument. 'Ihe net result is that just one objcxi i.s involved, which 
is coastmcLed in the called function's return statement. 

For example: 

//QiUct 

Foo X - GetAFoot )i 

//Calitt* 

Ft>o GetAFooO I 

retura FooCargL arg2): 

'Ihis is funclkmally eqiiwalent to: 

// Calltr 

?oo X Foofiirgl, arg2)t 

Note that this is not dependent on the callee being an 
inline fumlion. 

If the assignment operator is significantly more expensive 
than the consnucttir that is fx?ing used, it is better to use a fresh 
varialile for every function call than to try to re use the same 
variable several times, especkilly inside a loop. 

Hand over your data! 

Using this model the iterator's dereference operator needs 
to construct and return an object containing a subset of the 
information returned by PBGetCatInfo. We'll call this a 
Folderltem. Since this will liave quite a nurnlx^r of instance 
variables, we want to avoid having to pass every value as a 
separate constructor argument. A neat solution is to have 
Folderltem's constructor perform the call to PBCctCatinfb. This 
means we only have to pass three arguments to the constructor: 
volume, directory, and index. 

We also want to ensure that copying and assignment is as 
efficient as possible. Since the Folderltem will necxl to contain 
space for a variable-length nante, it makes sense not to use the 
compiler's automatically generated metliods, and instead to copy 
just the bytes that are used by the name. On the oilier hand, it 
is quite handy not to have to include an explicit copy rif every 
iastance variable^it is easy to forget to add an extra line if a 
new instance variable is intrcxJuced. We can have the best of 
lx)ih worlds if we define a base class that contains the name, anci 
a sulK:las.s that contains the other infonnalion. One uses explicii 


fopy/assignmeni methods, and die other uses automatic ones. 
As already explained, we also want to have FSSpec as tlic 
ultimate IxLse class. 

Hiis leads to the implementation shown in listing 1. 


listing 

// riass declaration Uj>t Ftiklerltem ajvd its Uaso 
class FiieSpec : public FSSpec 

// Cunstnictors 
protected: 

F11 eSpec () 11 //1 rsed when siihclnss iiiitjaJi/cs everything 
public: 

FileSpec(stiart vol, long dir, ConetStringPlr pNameJ 

vRefHmn = vol; 
parlD “ dir; 

BlockMovet>ata(pKame* name, pNametOj + l)i 


// Copy constnictOT 

FileSpec(const FlleSpeci other) 

[ *tbis “ other: ) //Uses^issignmcnt 

// Assignment opeiatof 

FileSpec^ orerator= (const FileSpec^ other) 

vRefNuia - other .vReftiura; 
parTU = other.parlD; 

BlockMoveUatalother.riasie, name, other,najne[D] ^ 1) 
return *thin: 

1 

// Comparison operators 

bool operatoK (const FileSpee^ other) const 

I return HelSt ring (name, other, name, fa lire, false) < D; 

bool operator™ (const FileSpecR other) const 

I return EqualStringCname, other.name, false* false): 1 
bool operator!^ (const Flle£pec& oihet) const 
t return ! operator™ (other) j ] 


class Folderltem : public FileSpec 

f 

public: 

// llIC SLltrihUtCTi 

typedef unsigned long Date: 

Date created, modified: 

Size data* resource: 

OSType type, creator: 

Boolean folder: 

// C/imiruciorii 

F olde r I tem () 1) // Nccckd wlx n tntaf i ng arrj)^ 

FolderItem (short vol, long dir* int index); 

// (Comparison operator 

bool operatorC (const Folderlterai other) const; 
bool operator™ (const Folderltera& other) cofiat: 
bool aperatorl' (const Folderltem^ other) const 
( return [operator™ (other): i 


Itere are only three non-trivial methtxis, all in Folderltem: 
the constniaor tliai calls PBCetCsitlnfo, and the two comparison 
operators. These have fairly olwious implementations as shown 
in Listing 2. 

U5«ijig 2: FoJdcritem.cp 

f/ linplcnTcntaLkxi of FoldcrJicin 

Folderltem:: Folder I lein (short vol, long dir. int index) 

vRefKuffi = vol: 
parlD dir; 
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pb,hPilelnfo,ioCQinplenon - 0; 
pb.hFiielnfo.ioVKefNuiii val: 
pb*hFiieInfo.ioDiriU “ din 
pb^bFilGlnfo^ioFDirlnd&x = index^ 
pb.hFilelnfo.ioNamePtr “ name: 

PBGetCatlnroSynr.(ipb): 

folder ^ pbJ)FlIeTnfo^ loFiAttcib £r ioDirHask; 

if ifolder} 

f 

created “ pb.dirInfo,ioDrCrDau 
undified pb.dirInfo.ioDrHdDai: 
data Oi 

resource = 0: 
type “ 0: 
creator = Os 
I 

else 

I 

creaLed * pb,hFileInfo,ioFiCrDaL: 

modified - ph.hFileInfo,ioFiMdDau 

data « pb.hFilelnfo.ioFlLgLen: 

resource = pbJiFneTafo,ioFLRLgLen; 

type = pb.bFlleTnfo.ioFlFndrlnfe.fdTypG; 

creator ■“ pb+hFlielnfO.ioFlFndrlnfo,fdCreators 

\ 

t 

bool FolderTten: ;operator“- (const FolderTteml^ other) const 

t 

retunv FlleSpec: :oper3tor==^ (other) 

&& created — otber.created 
modified “ other,ii»od If ied 
data “ other, da to 
hk resource ^ other,resource 
kk type “ other.type 
kk crcai^or =" other.creator 
kk folder ” other.folder: 


bool 

1 

Folderltem: 

:operfltor< (const 

Foldsrlteoii other) confit 

[ 

if 

(FUeSpnc:: 

:operator< [other)) 

return 

true: 

if CFilnSnnr.:! 

:operator!*(other)) 

return 

false: 

if 

(created 

< other.created) 

return 

true: 

if 

(created 

t" other.created) 

return 

false: 

if 

(ttodified 

< other.modified) 

return 

true: 

if 

(modified 

!= other, iiodif led) 

return 

false: 

if 

(data 

< other.data) 

return 

true: 

if 

(data 

other.data) 

return 

false: 

If 

Resource 

< other.resource) 

return 

true: 

if 

(resource 

I- other.resource) 

return 

false; 

if 

C type 

< other.type) 

return 

true; 

if 

(type 

1“ other.type) 

return 

false; 

if 

(creator 

< other.creator] 

return 

true: 

if 

(creator 

!■' other.creator) 

return 

false: 

if 

(folder 

< other-folder) 

return 

true: 

return false: 





I 


This takes care of most of the low-level grtini work. Tlie rest 
is fine,ss€. 

Asking for it to happen 

Typically, we don't want to create Foidcrltems directly. It is 
iimch more convenient to define a Folder chtss thar represents 
tlie entire collection, and obtain appropriately constructed 
[x)Lmdar>' tieraiors from it. 'Ibe Folder needs to store the volume 
and directory parameters, and it also needs to record the niinilxT 
of items in the folder so tliat it can supply an end() iterator when 
required This iteni count can be initialized in the consmicror, 
asing PBGeKJallnfo again. 

It is helpful to l)c ai>ie to construct a Folder eitlier from 


volume and directory^ numbers, such as returned from 
FindFolder, or from an FSSpec, such as returned from iterating 
anc^ther Folder. This enables recursive iteration of folder 
hiemrehies. In faa, it is possible to write a ‘super-iteratoF that 
iravemcs a hienirchy as if ii was a Hat list of files, Tliis involves 
storing a stack of folders and indexes, which is Relatively easy 
with STl, although it is stm lx*yond liie sco|x of tliis article. 

Since Folded tern requires die Folder's volume and directory 
infoniiation to be pas.sed to its constructor, it makes sense to 
have Fokier do the work of constructing Foklerltems. Hiis is 
done very conveniently by defining ati array subst:ripting 
operator, opemtorfl. Implementation of the Foklerllerator is then 
fairly trivial, since it is based on integer indexes, and delegates 
dereferencing to Folder: :operatorfl. 

Tliere Ls some circailarity in tlie definitions of Folder and its 
iterator: the iterator calls the subscript operator from Folder, and 
Folder has mctiicxls that return a Folderlicmtur. tt Ls necessary^ to 
tlelme Folderlieniior first, since Folder j>asses Fokierlleralors by 
value. iTien, although the implementation of 
Folderllerator::operalor* is inline, this Iills to Ixf postponed until 
after Folder lias been declared. Tlie results are shown in IJstuig 3^ 
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listing 5: FcikkTh 

clma Foltler; //Ixirwanl tlctbniTion 

// fla.w dcclunitlun fijr Foldcrlifrator 
class F&lderlterator 
I 

// (lisUuite v^irtablcs - 8 byics 
ccrnst Foldcrfi foidec; 
int index: 

public: 

// ConstrucTor - ^cii>lrd.scil index 
Folderlteratoricnnsr Foldt*r& f, int i) 
j folder(f). indoxtl) |] 

// Dcrcft'if nte operatnr 
folderltfrro opetutor* {) const: 

// Incrt^mcnt and dccamni 

Foldoriteratoiri operator-H- () 

( 'H-index: return ’this: I 
Fpiderlteratar operaLoH4 (int) //Piist4ncremcill 
[ return FolderTLerator(foider, index-Ht); 1 
Folderlteracotfe operator^ (j 
\ -index: return 'this; I 
Folderltcrutat operator- (int) //Ibstmmmm 
J return FoiderIteratDr{folder* index-); | 

// Compiirtson ujxrPUirs 

bool operator< Iconst FolderIterator& other) const 
( return index < other.index: I 
bool operator^ (const Foiderlterator& other) const 
I return index = other.index: I 
bool operator t- (const FolderTteratori Other) const 
I return index other.Index; 1 
h 

// CJiL'SS dccLiratton Folder 
class Folder 

I 

short vol; 
long dit; 

Inr count: 
publ!c: 

// (Jonslfticlon* ■ initialize ciiunt using PlKiciClaLlnfo 
Folder(short v. long d): 

Folder(const FSSpecA); 

// vSid)(st:npt ijp(Tatiyr 

Folder I tom operator [1 (inr )} const 

( return Folderltesitvol * dir, i + 1): I 

// tkmnds 

Folder Iterator beginO coast 

I return FoIderUcrstor(“thls. 0): ) 

FoldeTlterator piidO const 

I return FoldeElteratot(*thlf:, count); I 

// Number ofclcmaits 

int fiiseO const I return count; I 
// JnformntiiaT 

short voluraeO const f return vol: 1 

long directory0 const [ return dir: 1 


// llcfcrntxl implcnicnuiioii 

Inline* Folder Item Foiderlterator: ;opei:ator* () const 
[ return tolderlimlex]: | 

Tlie only non-irivial niethmls are the two consminors tor 
Polder. Tlictve h;ive stmiKliiforwarti iniplenientarions a.s shown in 

Listing 4. 

lisiing t itikJerep 

// ImpIcmcntaLlon td R)ldcrda*is 

Folder::Folder(ehort long d) 

; volCv)^ dirtd) 

( 


ClnfoPBRec pb; 

Str255 name; 

pb.hFlleTnfo.ioCompletion » 0: 
pb.bFneTnfo.loVRefHum vol; 
ph.hFlleiufo.ioDirlD = dir; 
pb,KFlielnfo,ioFDirIndex * I; 
pb.hFllelnfo.ioNamePTr “ mime; 

PBCetCatInfoSyiic(&pb): 

count " pb.dIrlafo.iohrNtaFIs; 

1 

Folder::Folder(const FSSpec^ spec) 

: vol{spec.vRefKum)* dIr(spec,purIC) 

ClafoPBRec pb: 

pb.hFileInfoJoCompIetion - 0: 
pb.hFileTnfo.ioVRefNum “ vol: 
pb.hFllGlnfo.ioDirID “ dir: 
ph.hFllelufo.ioFBirIndex ^ 0: 

pb.hFilelnfo.ioNamePtr - const_caBt<StringFtr>(spec,name); 

FBCetCatInfoSync(&pb): 

count = pb.dirinfo.iaDrHiiFls: 
dir ” pb.dirlnfo.ioDrDirrD: 


Seeing the wckhI instead of the trees 

It would Ik* easy lo lose sight of tlie lat i lluiL despite the 
iniplcmentaiion details, these classes are tlesigned to pnjvide a 
clean, reusable interface lor folder iieralitin. A rypical use niiglit 
he as follows: 

Folder thaFolder(anFSS): 

long EUin = 0: 

Folderlreraior p; 

for (p ' thcFolder,begin0; p I" LheFoider.end[); ++p) 

isum += (*p) .data; 

I 

Note that it is noi possible kj use p->data instead t)f 
(•p).d:ita, since ifie iterator returns a cot>y of the value and 
nol a reference to aji ofijeci with an independent existence. 
If imilliple ii-ses of were needed, it wrmki he much more 
efficient to create a n;mied variable initiali/.ed with *p. I'his 
is a .slightly dangerous aspect of the interface, since it is not 
tjhvious that each use of *p makes a fresh call to 
PHCletCatliifo. However, llie conveniente does seem to be 
worth the risk. 

Ilealdiy crilicism 

A natural qLie:>iton to ask at this (loint is wheliier using integer 
intlaxes wouldn't fmve iKcn simpler. Could this hyiK alxiui 
iteratois sini[>ly Ik another ciise of Itie Emperors New Clothes? 

In the example above, wiicre the folder is a local variable 
in the s;ime routine as the kiop, an integer approacfi would 
have worked well. However, W'c haven't looked at any 
algorithms yet. An algorithm using integers would require the 
container to I'k passed as an additional arguiiient. Some 
algoritliiiis take two injKit setjuences and prcxluce a third. 
OLitput sequence. This would be very cumlTersonie with 
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iriR'gers, espc<ially if the algorithm needetl to operaie on 
,suhsenK3as of a collection. A\m, an algorithm needs to he 
independent of any container type and so it ain't make any 
assuiTipiioiis ahoni l)egin() and endO meihixls, Kaw amiy.s 
which are a type of collection, tlon t even have any metluxls! 

Folderlterator uses an integer implemenialion internally, bill 
h carries around wiilun itself a reference to the associated 
collection. Tying essential infonuaiion together in this way 
makes it algorithm-friendly, and yet retains ilie simplicity and 
robustness of implemenLiiion asstxlated wiili anay substTipiing. 

Clll^CKJNG ExITNSIONS 

How miglit the foidcT'itcratmg facilities we have developed 
Ix^ put to use in a real-life appliealion? As mentioned in die 
introduction, it is possible to coiiiljine standard algoritlinis with 
our ow n iterators to develt jp a program 11 ml checks the System 
Folder for add!lions and changes to iLs extensions. As well as 
being a gt3<xi illustration of STI. principles, this could he a useful 
t<K>l in die continual batde u> keep wawart) iasudler programs 
under control. U seems almost an everyday occurreoce tliat 
obsolete extensions get insialled on one's syslem, or shared 
libraries are overwritten with older versions, both of w'hich c'tin 
lead to inexplicalile crashes at some random point in the future. 
Help stamp out iastallalion abuse! 

Piaiiiiiiig the strategy 

It is too lULiili to expect that one will reriiemlx.T to run the 
cheeking iirogiam ever^' lime .some new .software Is installeil A 
safer approach is to creitle a jirogram Fast enough to l>e run on 
every startup, that compares the cuirently iastalled exlen.sUms 
w ith llieir last kncjwm stale, and records a nt^w sUile if tliere have 
Ixvn any changes. This is combined with an interactive program 
that can generate an attractive display of the differences between 
any iwo slates chosen from a list lx>x. 


Tlic startup Ix^havtor breaks down into a numlier of 
discrete steps: 

1. Raid ihe cuiTeni list of ex Lens ions into memory 

2. Find and read ilx' previous list From a preference file 

3. Check iF ihe ILsis are equal 

4. Write a new preferent e Hie if they differ 

The interactive liehavior involves similar steps, bm a more 
complex algorithm at step 3: 

1, Read the 4‘iirreni list of previous preference Hle.s 

2, A.sk the user to chfKxsc two of iliese 

3, Analyze the differences iKlween them 
1 Display the res nils 

We won t cover the deiaifs of finding anti tTc^tiiing [>reference 
(lies here, or the GUI mechanisms used Kj disfday diFfertmees 
Ix'twwn sets. We will however kxik at all the algorithms in detail. 

Crcaiing a suitable framework 

As a Framcw'oik For our code, we define a da.ss Extensions 
that inherils Irom one of the STL containers. Creating, reading 
and comparing sets are then methcKls oF this class, Hie chiss 
definition i.s as foilcwvs: 

class lixt Efiis I ons : public std: i vccror<FolderItejn> 

I 

public: 

RKtensionsO 11 

KKT<?nRIons (short vKerMuJji): 

OSKrr R^ad (const IrliSpecJi]: 

OlsErr Wrltf^(const FSSpocir) rnnEt; 

hool openilQr= (const ExtensionaJi other) const; 
bool operator!' (const Extensions^ othor) const 
I return !operoior= (other); 1 
Is 
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The STL container class vector impletnents a 
dynamically sized array. The template ai^ument 
Folderkem specifies that this Ls lo be an army of 
Folclerl terns. 

All Standard Library classes and functions are placed 
in the namespace std. It is possible to avoid having to 
specify this explicitly by means of a using declaration in 
.cp files, but it is not a good idea to do this in a header 
file. Any client that includes sucfi a file will have the 
whole of the Standiird Library dumped into its global 
namespace. 

Reading the cuirent extensions 

We don't want switches Ixaween different Extensions 
Manager sets to be recorded as a change. We therefore 
read the contents of both enabled and disabled extensions 
folders and merge them into a single list. This is 
accomplished very easily with STL. The code for this is in 
die Extensions constructor: 

Extensions:: Extensions (short vRefNnofi} 

I 

long extenaionsDirXD. dlsabledDirLD: 

FindFolder(vRefNum* kExtensionFolderType* 

kDontCreateFolder, SvRefNuro, fir^xtensionsOirlDj ; 

FindFoldet (vEefNuTH. kExtensionDisabl edFolderType, 
kDonhCreateFolder, SvRefNura. idisabledDirlD): 

Falder extensionsFolder C vRefNiitn, 
extensionsDlrTD): 

Folder d IsabledFolder (vHefNuwi. 
disabledDirlD); 

std:•remove_copy_lf( 

extensionsFolder .beginO . 
extensionsFolder.end C)* 

std::back_inserter(*this), IsFolder): 

std: : reniove_copy_if { 

disabledFoldsr.begin0, dlsabledFolder.endC). 
std::back_inserter(*thie)* IsFolder): 

std ; :sort CbeginO , end()) : 

1 


contents of the two folders. We then sort the entire list 
in order to merge the two sections, and to make 
comparison with other sets easier. The arguments to the 
sort algorithm are very simple, because the compiler is 
able to deduce much of the necessary information from 
the data types being used. The comparison function 
reverts to the less-than operator unless a specific 
predicate is specified as a third argument. 


Saving and restoring sets 

The i/o functions are mostly plain MacOS code, 
except for die computations of the length and address to 
read or write. Itie resizeO mediod Cfrtjm sid:-vector) 
changes the number of elements in the vector, and the 
sizeO method returns the current number, 'llie beginO 
method returns an iterator for the first clement of the 
vector, but since vector is an implementation of an array 
this iienitof is in fact a raw pointer to the beginning of a 
contiguous block containing all the elements. 

OSErr Extenislons:: Read (const FSSpec& file) 

( 

reslxe(FSpDataSizeC&file) / sizeof{Folderltem)): 
short fiieRef: 

OSErr err = FS|>0penDF(6cfile, fsRdFerin, &fileRef) : 
if (ert noErr) 
return err: 

long count ^ sizeO * slzeof (Folderltero); 
err “ FSReadCfileRef. Stcount, beginO); 
FSClosetfileRef): 
return err: 

I 

OSErr Extertsloria:: Write (conni FSSpec4 file) const 
I 

FSpCreateC6ffiie. '71^1*. 'ESET* . smSystemScript) : 
short fileRef; 

OSErr err = FSpOpcnDFC&file, fsWrPeriE, ^fiieRef) : 
if (err != noErr) 
return err; 

long count •• sizeC) * slzeof (Folderltem) : 
err “ FSWriteCfileRef, Scount. beginO); 
FSClose(fileKef); 
return err: 

1 


The STL algorithm remove_copy_if copies iLs input 
sequence—here corresponding to one of the two folders 
— to its output sequence, removing any elernenUi that 
satisfy the given predicate. The predicate used here is a 
small user-defined function, tsFolder, defined like this: 

inlino bool iaFolder(const FolderltemS Item) 

( return item.folder: I 

'llie output .sequence is die collection stored in the 
Extensions object, which is a container derived from ve<for. 
However, we don't know in advance how many elements 
will be needed, so we append them one by one using a 
liuc:k iaserter. Tlte cximpiler is smart enough to figure out 
what template arguments to use based on the data that is 
passed to lxick_lnserter. 

'I'he two copying algorithms generate a list of 
extensions that is a straight concatenation of the 


Tliese funaions, as written, are radicr wasteful of disk 
space and i/o bandwidth, a.s most of the 256 bytes in 
FSSpec's name field are unused. A belter solution would 
be to compact the items into a character buffer, using 
variable-length space for die names, and write that buffer 
to and from disk. 


Comparing sets 

Checking for equality between Extensions collections 
i.s a very simple application of STL calls: 


bool Extensions: loperator^ 

(const Extensions& other) const 


I 

return slze() ^ oth^r.aizeC) 

&& std : lequallbe^inO , end () , other .begin ()) : 
J 
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Tlic equal merhcxl expects its inpui .sequences to l>e 
of the same length, so it is necessary to check the lengths 
for equality firsL If the lengtlis differ the sequences are 
obviously different. 

Determining the differences lictween collections is a 
little more inlercsting. This is implementeti as an 
algorithm using iterators, to allow it to he used with any 
container type and not just vector. For die same reason, 
we have not made it a method of Extensions. 

The algoritlini detennines which items have [xx:n added, 
a.'tnoved or ciumged between two sequences of Polderltems, 
and appends the results to iLs iliree output sequences. S'FL has 
a grotip of set algoritluns tliat work on sorted setjuences, and 
dtese arc ideal for the implementation: 

tPinplat«<class In* class Out> 
void PolderDifferences( 

In b<?gin1 , In €sndl, 
in begirt 2, Tn end2* 

Out aniquel, 

Out unique2, 

Out changed) 
i 

tjfllng namespace stdj 

uec LOr'<FolderIteifl> coinmonl. coimnon2 ; 

s€t_di£ference(bcginl* endl* beginZ. end2* 
uniquel* less<FlleSpec>()); 
set_difference(begin?., end?* begin!, endl* 
unique?* iess<F±leSpee>C)); 

set_JnrersecticnCbeginl* endl* begin?, end?* 
back_lnserterCcommonl)* less<FileSpuc>()): 
9et_lritcrsecT ion (begin? * end 2, beginl, endl* 
back_inserter (comninn?) * less<FileSpec> C)) : 

9 et„difte renc e C 

common? * beginC )* common?,end 0, 
commonl - begin 0 * conmionl - end (} * 
changed): 

1 

The sel_diffcrcnce algorithm produces a sec|uencc of 
elements that are members of its first, hut not its second, 
input sequence. This is used to dcieniiine which items are 
unique to the first set* and then those unique to the 
second set. Tlie setjntersection algorithm produces a 
sequence of elements from the first sequence that are also 
found in the second sequence, Tliis is used to determine 
which items are found in both sets, ft is used twice, to 
generate separate lists of common items from each of the 
sets, because the common items will later need to be 
c:heckcd for attribute differences. 

In each of the first four set operations, the items are 
compared as FileSpecs rather tiian Folderltems, because at 
this point we are only interested in the names. Other 
attributes may differ, but if the names are the same we 
regard two items as one item tiiat has been changed. 

We arrange for the algorithm to make comparisons 
on this basis by passing a predicate as an additional 
argument. This predicate* less<>, is actually a template 
class fnim STL and not a function. Such classes are 


referred to as funciors. The name is folk>wed by 
parentheses in the argument list because we are 
constructing an unnamed teiiipt)rary object and passing 
a reference to it. The algorithm calls the tibjecFs 
funait>n-call operator, operatorO, to perfi)rm the 
comparisons. The function-call operator of less in turn 
uses the < operator on its tw’o arguments. By specifying 
Files pec as the template argument, we ensure that the 
function call will take arguments of type const 
FileSpec&, producing iIjc kind of comparison we w^anr. 
Fortynatcly, it is not necessary to understand why it 
works in order to use it! 

I1ie final use of sel_diffcrence picks out the items 
from the second set that differ fmm their namesake in l!ic 
first set. Tills time native Folderltem comparison is used, 
because we want to take all attributes into account. No 
special predicate is required. Ihe reason set_differencc 
produces the result we w'ant is that unt:hanged items will 
be members of both common sequences, whereas 
changed items will not. 

It would have been slightly more efficient to write a 
custom loop to implement FolderDifferences. This would 
reduce the numlK:r of element comparisons that have to 
be performed- However, the compute time is small 
compared with the rime taken lo scan the extensions 
folders in the first place. The clarity and ease of 
implemcntatiori easily outweigh the cost. 

PowerPlant, anyone? 

The algorithm is used as follows: 

vec tor<F<itderItera> unlquel * unique?: 
Vector<FolderTtein> changed: 

FoldexDifferences{ 

previous.begin(), previous.end(), 
current.begin()* curreru .end()* 
back.inserterCuniquel), 
back_inserter(unique?), 
back^ineerter(changed)): 

These three vectors can then form the inpuLs to a tliree- 
panc PowerPlant window that displays the differences in 
tliree columns, A doubfecltek in llie Changed column couid 
produce a dialog box dial compares the item's attributes in 
each of the two sets, 

A subtle point that Is often overlooked is the fact that 
the elements of die output sequences do not need to be 
of the same type as the elements of the input sequences. 
Provided there is an appropriate assignment operator, 
eiements will be converted as they are written to the 
output. The three output vectors ab<.ive could have been 
vector<std::string> if there is an operator that can assign 
I'Olderitems to strings. 

For testing, it may l>e appropriate to send the output 
to a text window, STI. can help witii this too. First a « 
operator must be wrillcn to output a Folderltem onto an 
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ostTCiim. 'Hien, an S'iX <>sireani_ item tor c'lin fx.* used to 
copy an entire vector to an <jstrinij;.sireanL IXe code looks 
like this: 

ofltrlngfii rciHTii : 

if (ur> Lquel * £jize() 3 

1 

text << “Previous oniy:\r"; 

copy tuniquel.begin C)* unI quel.end{}, 

ostreain_iterat'orCFoldoriteiii>(text. ^\r“3) : 

\ 

if (unlqne2.s f ) 

I 

text « “CurrerLt only:\r“; 

copy (Litiique2 , begin () . uniqueZ . end 13 i 

oatream_iterator<FolderTtom>(text, "\r"3): 

1 

if (changed.slzeC)) 

f 

text C< “CKangod:\r“; 

copy(cbanged*begln(3. changed * end(), 

os? rcani_lteratoi:<^FoXderIteni> (text t "Vr*')3 : 

I 

Tlie string argument of the osiream^iterator will he 
outj^iit alter every Item. As used here, this will put each 
item onto a separate line. The geneniled text can llien he 
assigned to a FowerPlant text window' in (me step: 

tnTcxi View->SetTextPtr ( text * St r () . begin () , 

1 ext, str () » size 0 3; 


Pahting Shots 

Tlij,s aiticle explores the principie,s behind the 
Staiuianl Tcmplafc Uhrnn> in ,soiiie defiih, especially %vith 
regard to the role of itenttors. ft also ininKltu'es a 
representative slice of STL's capahilities in terms of 
algorithm-s, containers and iterators. 

Unforiunalely it is not possible Uj do proper jusiice 
to the Library in such a brief presentation, and ifie 
reader Is encouraged to continue learning about STL 
through the many liooks and papers ihai have been 
wTitten on the suhjed. Most good C++ books 
novvatiays devote a significant proportion of their 
length to teaching the Standard Library, and incleed 
any C++ book that does not should he treated with 
some skepticism. Stroustruj) (,see fiihliography) 
devotes almost half the ix>ok to the Library, and uses 
library features in examples right from the firsi chapter. 

STL ill relrospect 

S'IT encourages a wry dilTerent style of [Programming. 
Very' few' loops ate scx*n, and a varief)'' of powerfiil library 
functions are used instead. Code is written in terms of 
logical tPfperations on entire eolleelion.s. 

Although STL's eapabililies are well thought-out and 
rcmarkahly c'ompreliensive, there are inevitably a few 
elutn,sy areas, and limitations diat can be frustrating at 
limes, llowevet; as the scmdard Ix^gins to receive wide 
acceptance throughout the C++ indusiry, it is worth living 
with all of tliese limiiatlon.s in order to reap Lite benefits 


of having a much-needed common stanclarcL One has 
only to ItKik at the ground that has liecn lost to other 
languages to realise how much the lack of a siantlard 
library has huit the language. This is a pity, as the power 
and ilexibility of the Standard Template Libmry are now 
far, far ahead <jf any ec|uivalent capability available in 
other languages that don't implement templates. 

Where there are limitatitjns in STI., it is usually 
possilplc to overtxpme these relatively easily, due to the 
Library’s highly extensible design. New' containers can Ik: 
added that will work ,seamle,ssly wiih all of the standard 
algorithms, and new algorithms that work w'ith all of the 
standard containers. New iterators am Ix" developed dial 
allow existing algorithms lo perform in ways not 
previously possible. All of these additions can lx: made by 
the application developer as required, either on an ad-hcK 
basis for a single application, or as pan of a private library 
of reusable capabilities. Fither way, code quality and 
clarity is greatly enhanced, 

C++ in rctrtpspect 

Much has been said about this remarkable 
language, both gocpd and bad. Whatever else is said, 
there is no denying that it is lean, elegant, expressive 
and advanced. These are ehuraclerislies to die for, 
amongst serious [programmers. Hard work and 
discipline^ are needetl in reaping the benefits, but the 
results are admirably worth it. 

It i.s often said that C++ is a 'large' language, in that 
ilR^re is a lot to learn and remember in order to 
become proficient in using it. U certainly tlidn't start 
out as a large language—in the early day.s it was 
considered a big improvement on Ada in that respect! 
(>+ i,s aciually based around a relatively small number 
of features thoughifully and con.sistenily applied. If 
these concepts are di,scovered and learned, the rest of 
the language will inevitably fall into place. 

C++ has some uniejue feaUires. Well’a[)[5lied. ihe,se 
can make ki huge difference to cpur software development. 
Learn them, and use them! 

BlUUCHiRAPHY 

1 have refrained Irom induding a hibliogniphy with 
every article. Everything 1 have wntten about may be 
found in any gcKxl C++ bonk, and there is no shortage of 
those. However, I cannot let ilits series pa.s.s without 
acknowledging the rncredihle debt tliat we owe to Bjarne 
Siroustmp, the creatcjr and refiner of C++, and I can tliink 
of no better C++ reference than his ow'n. It is 
comprehensive, and provides unique insight into how^ the 
language is designed and the Lx^st way to use it. 

• SiroiLstrup, Bjarne: Tlie C++ Programming Hinguage. 
3rd edn. Addison-We.sley. Re;iding, Mass. 1997 El 
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Sai(?tmg Sat^s Time - InsrallerMaker 
provides full scriprabiliry for all features. 
Automating the build prcKCSS saves time 
and helps ensure the iiuegriiy of your insraller. 


Triahmre in Minutes - Creating trialware is a 
breeze with lustallerMaken With just a few ^ 
clicks, and no extra coding., you can create M 
tria I wa re tha t is e-ct >mmcrcc ready. 9 


Update in a Flash - Hasily build intelligent ^ 
"diff" files in installers to create small updaters for quick 
online distributioiK From one simple installer, you can 
update 68k, PowerFC or FA T applications. 


More Details Online - There^s a lot more 
InsiallerMaker am do for you. Or ail tbe 
info at \vww.aiaddinsys.com. 
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• Installation 
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When Time Is Money, Get It Done Fast! 

Build Smaller Installers - Wirh Stufflr liistallcrMakcr, you'll build installers 
faster than ever before! Compress your installers an average of 15% smaller 
using the ptrwer of the Stufflt Engine’. Smaller installers download faster, 
provide added space on CDs and ser\'ers, and increase nework bandwidth. 


• Resource 
Installation 


Quickly Create Demoware - Easily turn your application into a polished 
demo. Just set the number of days for the demo to be active, paste in the 
graphics, and you’re done! 
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Archive Fteshening - Automatically update your installer project file; 
eliminate repeated searches for modified files. 


Marketing 

OppdYtunities 


-Suppoit 


Built-In 

Updaters 


• Hierarch ica 






MAC OS X 
DEVELOPMENT 


By John HornkiHst 


Hot Chocolate! 


An Introduction to Cocoa 


lNTRl)DlJ<mt)N 

Mac OS X is Apple's great gainl)lc for 
ihe fiitiire* It does away with alniCK^ two 
decades worth of heritage, and brings 
advances such as preemptive muliilasking, 
virtiuil memory and menK)ry piotection to 
the MatinUxsh. The traasition, however, 
requires tliat developers port their 
appitaitioas to one of two new APIs; Cadxjn 
or Gk:osi. While Otrbon is clearly die Ixisic 
element in Apple's plan ft>r bringing existing 
Mac OS applicatioas to die new ttperating 
system, Oxxxi offers great opportunilies for 
deveIo[X.Ts dial bring new^ applicatioas to the 
market, and to dicxsc lltat are to rewrite from 
a (‘lean state. In this article, f will descTilx: 
wltil Qxitja is, and how^ you can take 
advantage of it. 

Apple has repeatedly pointed out llial 
you can write Cocoa applicatioas in eitlier 
Olijective-C or Java. However, CxKxxt itself 
is an Objective-'C system, and you'll 
probably enjoy more of its benefits if you 
use Ob[ective-C yoursclfi Tlierefore, all 
ctxle examples in this article will lx‘ in 
Ol>fec:live-C 

Heritage 

Coc'oa i.s the latest name for tlie object 
oriented software frameworks and 
technoligies Apple received in ilie NeXT 
Lakeoven In previous incarnations, the 


technology has been know as YellowBox, OpenStep and 
NEXTSTEP — and until now, the largest step by far happened in 
the transition from NEXTSTEP to OpenStep. 

The greatest difference l:>etween Cocoa and its predecesscjr Ls 
the repkeement of Display Postscript by Quartz. While DPS was 
a very powerful graphics engine, it wa.s a client .server system, and 
an interpreted language, which combined to make life difflcuti for 
die perftirmance oriented developer — it was possible to gel 
excellent performance out of DPS, but it required an intimate 
understanding of die graphics pipeline! 11 With Quartz, graphics 
display has been moved to a shared memory nxKlek making 
graphics programming as tionvenienr as the rest of Cocoa — at 
the cast of making remote display “a tlurd party opportunity''. 

CtKxia has also gained many im[X>Ttant com[ioncnLs nsince 
Apple Ux)k over, such as the tkxniment architetture and stTtptability. 

Cocoa is the latest name for the object oriented software 
frameworks and technoligies Apple received in the NeXT 
lakeoven In previous incarnations, the technology has been 
know as YellowBox, OpenStep and NEXTSTEP — and until 
now% the largest step by far happened in the transition from 
NEXTSTEP to OpenStep, 

The greatest difference between Cocoa and its 
predecessor is the replacement of Display Posiscripi by Quartz, 
While DPS was a very^ powerful graphics engine, it was a client 
server system, and an interpreted language, which combined 
to make life difficult for the performance oriented developer — 
it was possible to get excellent performance out of DPS, but it 
required an intimate understanding of the graphics pipelinell}. 
With Quartz, graphics display has been moved to a shared 
memory^ model, making graphics programming as convenient 
as tlie rest of Cocoa — at the cost of making remote display “a 
third party opportunity". 

Coc'oa has also gained many importani conifXinenLs since 
Apple tcxik over, such as tlie ikxiiment architecture and scriptability-. 


John Hurnkvist is a master student at Chalmers University of Technoiog>^ in Gotelxjig< Sweden. He has created a unique 
academic niche by working on MSc degrees in.lxxh “Computer Science and Engineering" and “Industrial Engineering and 
Managenieni of Technology". Outside his studies, John has been doing NeXTStep and OPENStep developmeni since 1994, 1x>l1i 
as an independent developer and as a consultant. His work includes Magnachana, an application For lechnical analysis of stock 
trends, and the Graphickil, a IramewoTk for sfjuctured gmphies. John ts also the founder of loastedmafshmallow.com and on 
lie reached as john^ioasieilmarshmalbw.cum. 
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The OBjEcnvE-C Language 

Object!ve-C i5 ihe I)rain child of Brad J. Cox, and tiie result 
of his worries at)Out the difference in productivity between the 
hardware and software industries. In the early eij^hties, he 
noticed that software development prcxluctivity was on a 
worrying growdi curve, and prediaed a software crisis if 
development methodologies did not change. Dr Cox attributed 
the difference between hardware and software industries to tlie 
fata that lIjc hardware industry used components, such as 
integrated circuits, ICs, in their designs, and created new 
components only when necess^try. The software industry, at the 
time using C or Pascal, lacked llie component based approach 
to development, and Dr. Cox set out to change that. 

*lfie result of Cox’s work w'as Objectlve-C, a dynamic object 
oriented language in the Smalltalk tradition, but built on C. 
Objective-C allows you to use "'software ICs”, using Cox’s term, 
to do component based engineering, and if alk)ws yoti to create 
new' components all the way dt>w'n to the ""transistor lev el" since 
it is built on C. Objeciivc-C allows you to drop hack to C, but 
trying to WTite the prograin as much in the “Objective" part as 
possible is a Ixitter approach, much like hardware engineers 
sliould avoid imfileinentitig their designs at the tnmsBtor level 
— unless there is a compelling reason, such as need ff>r extreme 
performance, that validates the a level approaclL 


Syntax 

Objective-C extends the C syntax in some simple hut very 
powerful ways. Most imponant is the overloading of brackets as 
a shonliand for message sending. 

Sending a message 

There are two ways of sending messages; a cunibetsome 
way using traditional C syntax, and a simple way using the 
Object!ve-C syntax. 

obj c_ms gSend(someObject.^selector f soraeSelec tor;).soraeAtgumen t): 
[someObject soiiieSeI^ctot':sC3iiieArgutnent] ; 

However, the ObjecLive-C syntax is most beneficial in cases 
W'here you have many arguments to a method, 

Tile NSStiing class has a method that lets you compare a string 
to pan of another string, with some options, such as case seasitivity, 

result-objc_DisgSend{aS t cing,^selector(compare:op tions:range:). 

anorherSt ring.NSCaselnsensiLivcSearch * 
IISMakeRange (0.10)) ; 

result* faString compare:anotherString 

options:SSCaselnsensitlveSearcb 
range:NSMakeRange(0*10)]; 

Even in a iradilional C syntax, w'ithoui methods and 
messages, the code would still read 


Objects, Instances, Classes, Methods and Messages 

Many of the terms used in the article will already be familiar 
to most readers. Some would claim dial die teniis are familiar to 
all; quoting Dr Cox: 

*"Betsy is a cow" is just a short form t)f ""Betsy is an 
instance of elass cow." 

What may be new^ to some is the context where these 
terms are used. 

An oi)ject is a set of private data and some operations, 
methods, that can access and operate on that data. It is also 
an instance of a class. 

Data Is conLained within objects as instance variable. In 
some language, you can also store data in the classes 
themselves. There is no support for class variables in 
ObjecLive-C. 

A message is a request .sent to an object in order for it to 
perform a methtxi. 

A class is a cla.ssificadon of an object, as well as a concrete 
entity in Objective-C. You can instruct a class to create an 
instance of itself, and all objects know what class they Ix'long to. 
In fact, classes are objecLs themselves. 

Since you can send messages to both instances and classes, 
it IS sometimes useful to make a distinction l:>etw'een instance 
methods and class metfiods. 

A framework is a dynamically loadable library of classes, 
categories, pmtocoi.s, funaioos, and everything el.se you’d 
expect from a linked library, tiptionally bundled with header 
files, documentation and other resources. 


res ult=c omp a reWit hDptionsAndRan ge(aS t rin g.an ot h e rSt ring. 

NSCaselnsensitiveSearch, 
MSKflkeRange(0,10)): 
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I L'xpc'ct Lluit once ustd to the .somewhat alien look, most 
will find the Objective-C syntax very easy to a^ad. 

Creating a cla.ss 

To create a class, you s^art wiiit writing a [leuLier file, whidi 
holds tlie interface declaration, mucli like with tmditiorud C or C++. 
Tile following i.xxle sample shows a simple siilxlass of NSObject: 

# I mpo r i < F<jy n d a 11 an / Faiiada tian, ti> 

^interface KitchenTooiiNSObject 
f 

NS St ring* najne: 

I 

*1- (Kltishf^nTool neyKItctienToalWiLtiMaaie: (NSStrlng* JaName 
{NSSUlng*) tiaiiie; 

Tlie nante of tlie dass Ls KitchenTcxjl, its sLijx^r class is 
NSOlijLxt, it htus an instance varial>le called name, yon cietite it by 
calling tite class method iK'W'KildienTtHilWiihNaine: (c:lass methfxls 
liave a plus sign ratlier than a minus sign Ixfoie tlieir dtxlaralion) 
and you urn retrieve a KkiIs name by calling the name method. 

You also create an iniplcmemalitm of the object, containing 
the definition of its methods. An imjilementuitm tif KiicheoTtK)! 
would kxik like this: 

^import "KltchtfnTaai.h’' 

©implementation Kltchentcwl 

+ (KitchenTool*) newKI trhenToolWf tliNiSittc': (MSSl ring*)iiNmnE? 

I 

KitchenTool’ nt'wKltchonTool=|[KitchenTooi allocj inltj : 
ru^wKUfhett'l'ool >tinnie = [aName copy]; 
re Lurti tievKl tchenTool: 

1 

- (KSString*) name 
t 

return nnine: 

I 

(void) dealloc 

1 

[name release!| 

[super deailocl: 

1 

eenci 

'lake note of the dealloc method; every class ihai lias 
o[>jec‘ts as instance variables slioukl have a dealloc inclliud 
which releases mstance variables during deanocation. 'I’he 
deallcK' method sends a message to sujkt, which means that the 
iinplemeniarion of deaihx in NSObject, KitchenTorjlN su[kt 
class, also gets called. 

You may also note that in the newKitchenTtKilWithName: 
metlxKl* the da.ss objed acce.s.se.s the object as a structure. ‘Hiis 
is allowed because the class methods are part of the 
implemenlatitMi of the class, hut I do mil recommmed using this 
feature except in aealors for immutable classes. 

Tlie use of an ?^tmport direaive rather tlian ^include avoids 
loading the .same header file multiple limes. 


Self and Super 

Wtien you send a message to an object, you p,ss the object 
a pointer to iLself, which is called self, Ihe exLstance of self lets the 
object use nietlicxl [lassing and send messages to iiselh Avoiding 
direa access to insi;ince varkibles, except in direct access^ir 
methods, and splitting large methexLs into nuiny smaller ones 
increases tlie jx)wer of inJieriiantr, and is highly lec'ommentkxl. 

Sometimes, you need to access a sy[K:r class' definition of a 
tniMlKxl, even though yoifve overridden it. To send a message 
that invokes die irnpl erne mat ion in the superclass, you use super 
instead of self when you send the message. 

Dynamic features of Objective-C 

Tile use of messiige passing instuad tif function ealLs in 
Objectlve-C has s^inie interesting consequences. Among odier 
d lings, it allows posing, forwartling, categories and swizzling. 

Another elTecl of dynamic message passing is how overriden 
methods ate handletl: if you have a class that implements 

- (void) someMethod 
t 

\self someHetbodUithNumber:S1; 

) 

(void) someNeLhadWittiNxunber: (int3 aNumber 

! 

// Du somediing wilii luuutnrr 
1 

and a sulxlass that overrides tliis with 

• (void] pomsWpthndtffthNumbtv :{liu loMimber 
t 

// l>ti sonusliing difft'R'Ul wirb ii numiKT 

I 

then, when someMelhod is called on an instance of tlie 
subclass, stJmeMetlHKl will use the subclass’s implementation of 
.someMethfxlWithNumlx'r: rather than the impleiiientation in die 
c lass W'^here sonieMelhcxl was Liefined. 

Posing lets a class lake the place of its parent in the object 
hiemrehy. The preni class still exists, so die ptxsing object can 
still eallt super, but instances of the parent class will never lx* 
civated; iosLead, instances <if \\\c [Xiser will Ix^ created. A posing 
class cannot declare new instance variables. 

Fnrwtirding is used as a fault handler; when an object 
receives a message for metlKxl that it dtxsn't implement, 
fonvarcling gives it a chance to [lass the message on to another 
objext, or provide some other enor handling. 

Caiegtifies allow you to override f>r add metlxxis to an existing 
class, without iKtving to avale a .sulKlas,s or ac:ct^s die ,souix:e. 

Swizzling lets you change the class ol'an objed at any time. 
This is a dangerous thing to do, but it can be very useful. 

To find <ait mutr alxmi ObjetliveC, I suggest reading 
Objeci-Orienietl Programming anti the Objcciive-C Linguage, 
which is available at 

<http://developef.apple.eom/tedipubs/macosx/ObjeaiveC/index.html>. For 
a detailed view, you can also download the iniplememadon of 
the Objective-C aintime from the Darwin effort. 
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I'kamlworks 

There are three major parts of CcK’oa; Foundation Kit 
{Foundation), Application Kii (AppKii) iind EnteriJnse Objects 
(EOF). FoiintFiiion is die lowest layer of the system, classes dial 
can Ix' used whether you’re [>ui!ding a program without any user 
interface, or an appliaitifin with a gnii’ihical user interlace. Tlie 
AppKEi Ls built on lop of Foundation, and prtwkles graphicil 
functioas, as well as high level objects that simplify the 
construction of aj'jplications. Enterprise Objects is a set of 
framewTirks, some built on Foundation and some on AppKil, ihai 
provide asttJLindiagly easy and powerful access to cbitabases. 

Foundation Kit 

Tile role of tljc Foundadon Kil is shield the programmer 
from the underlying o|>erating system by providing calls for 
memory alkx'ation anti deaHtxatiiin, file access, shared memory, 
thread management task maintgement, inter prcKess 
conimunication and so forth. It also provides some basic tiiiliiy 
classes, such as strings, array.s and ditiionaries. 

One of the mosi coninion misUikes of fledgling Ccxoa 
programmers is to underestimate the riclmess anti flexibility of 
the Foundadon classe.s. Take a gfKxl kxik at die Foundation 
class hierarchy lie fore you start wailing nny new' code! On the 
oiher hand, a commcai mistake of more experiencerl Crx'oa 
programmers is to overuse the Fountiation classes. When you 
know something about your data that can help you make more 
effic:ienl use of memory and processfx power than what 
Foundation provides, then you should use that knowletlgc. but 
make sure that Foundation's clas.ses don't suffice first. 


tr for example, you have d;Ua that you need to lie indexed by 
ckite, you etruld eillier put it in an NSDidionary, or, you could make 
your ow'ft specialized clas.s for thai ckita. Tlic .sjxt:iali/cd ckiss Ls uLsy 
to write, ami provides Ixnicr pcrfonnance, but, writing it creates 
meaas hav ing an additional cht.SsS to test and debug. 

Mutable and Immutable objects 

In the Foundation Kil, you will find clas,ses named NSArray 
and NSMutahleArray, NSString and NSMuiableSiring and si) forth. 
An immutable object, such as NSArr4iy anc.1 NSString, cannot lie 
changed; its contents are set at the time of creation. A mutable 
object, on the other hand, can have its contents clianged ai any 
time. 'I'liLs difference is very uscTuI, since it allows llic developer 
to make some opUmiziiLions. For example, if an object contains 
an NSArray, il c“an Siifely pass tiiat airay lo amaher objecf without 
risking that tlie array changes, even tliougli tlie objects in die 
array can still cliange internally, [f the oliject uses an 
NSMttlablcArray, it is prudent to return a cr>py of the array. 

One should also consider tlie jiossibiitty of muLaijility when 
an olijec’l is returned from a meUicxI. Even if tile interface 
specifies that a method returns an immutable object, the receiver 
should not rely on die iinmutaliility of it; sine e tlie mutable class 
Ls often a snbcTass of tlie immuLable clas.s, the compiler will 
accept an NSMu tabic Array instead of an NSArray, for example. 
This also affects thiead safety of the i lasses. While immutable 
ohject.s are generally safe to use in a muUi threaded a[)plieation, 
miiiaiile objeets need special care. An example of an unsafe 
iuipiementation is show in listing I. Fnnlier dLscussion on 
multitbreatiing in Crx'oa is outside the scope of this article, and 
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in fact, Apple has not yet imde public wliat cliLs.ses will he 
tfircad safe in Mac OS X, although it should be safe to assume 
that classes that are thread safe in earlier version of the 
framework will remain sSafe. 

Lifting 1: Unsafe use of collection objects 

(void) misaf eHethod 

[ 

NSMutableArray* someArray = [aonteObject 1 orsOfObjects]: 

Int count “ fsanjfiArray ceunt]; 
int i: 

for (i-O;i<countii++} 

I 

[ [soiaeArray objectAtIfidex:i] doSom€thing]; 

1 

1 

- (void)unfiafeKothod 
I 

NSArray* aoateArray = [sonieObject lotsOfObjectsl; 

// “ Unsafr; tlK antty may be mutabJe 
int count - IsoneArray count]; 
int i; 

for (i-Ori<count;l-H) 

( 

ItsomeArray objoctAtIndexri) doSomethingJj 


1 


Enumerators 

Enuincrators are objects that represent iteration over a 
collection of objects, sucli as an array or a dictionary, Hnumerators 
provide a consistent interface to several kinds of collections, and 
using them gives axle that is easier to read and to cliange. It iilso 
pn:>tecis you (nnn wt>iTying ab<)ut changes in the collection you 
are iterating over; you entrust tliat to die enumerator. 

Listing 2i Iterating over a collection with an enumeraton 

(void 3 sa fe rHet h od 
I 

NSEnunerator* enumerator = flEomeObject lotaOrObjects] 
objectEnuraeratorl i 
id theObJect=TilJ; 

while (t.heObject=[enumerator nextObjeetj 3 
[1h eObj act do S omething J: 

I 

The drawback of enumerators is a sliglit jx^rfonuance cost, 
and sometimes delayed destnicrion of objeas. 

Class clusters 

Cixss clusters are used extensively in the Foundation Kit. 
iTieir role Is to give a comnujn interface to a set of anonymous 
classes. There is a ela.ss called NSArray in Foundation, but no 
NSArray t)hjetls are created when a program runs. Instead, when 
you try to alkxate an NSArray, you’re given an instance of one 
of NSArray’s subclasses. Otlier class clusters include NSDate and 
NSSlring. For each class cluster, diere is a minimal set of 
methods that a sulxrla.s.s has to implement in order to work as a 
memlxr of the cluster. 

When an objecr is the root of a class cluster, you can’t easily 


.subclass ir to add functionality. While diLs may seem limiting at 
first glance, it is very easy to work around. Instead of writing a 
subclass, you can write a category on the cluster's root class 
which extends its behavior or you can use composilion to create 
a cla.ss that combines the capabilities of several classes. 

If for example, you wish to create an object that b both an 
array and a dictionary, you should not do it by creating a 
subclass of NSArray and implementing dictionary methods on 
that. Instead, create a new c:la,ss that compases the functionality 
of an array and a diedonary. 

In faa composition is a very powerful technique, and by 
using it wisely you’ll find that your programs Ixcome both 
smaller and more flexible. Comfxjsilitm is described in detail 
later in this article. 

Object ownership 

An imponant pare o\‘ Foundation Ls memory management. 
Qxoa uses a system known as manual reference counting. When 
the reference a>unt of an olijcci reac‘hes zero, it is deaUocated, 
Listing 3 shows how an objea can handle retain and 
release. Note that when an objea is allocated, all its instance 
variables are set Lt> nil. Since Ohjecrive-C disregards message 
passing to nil, it is safe to send messages tt) uninitialized objecis. 

Listing 3: An example of retain/relea,se in an object 

^ in t er face KyDa t oKe e pe r: NSOb j et; t 
1 

NSDate" theDatej 

I 

- (void) setBatei(NSDate*IsomeDate; 

' (NSDate*) date; 

@end 

»i mpI eme n t a 11on My Da t eKe e pe r 

(NSDate") date 
f 

return theDate; 

1 

- Cvoid) setDate: (NSDOL 0 ") soiocDaie 

I 

NSDate' lrapDate=theDate; 
theDate = [someDate retainj; 

(uapDate release!; 

- (void) dealloc 
I 

[theDate release]: 

[fiuper deal toe]: 

1 

^eiid 

Tile rules of retain and release are a^lutively simple, but 
nonetheless, it is an area where j^rograrnmers lend to err. For 
example, the unsafe methtxJ in listing 4 slujws a coinmon 
ini.stake among unexperienc'ecl CcKoa programmers; it is easy to 
forget tliat while die c<3nveniic)ns for object ownership state that 
unless you get an object by calling alksc/inii or copy, you don't 
have to release it, It is not guaranteed that the object will stay 
alive unless you retain it. Ijearn the rules by heart, iDecause 
retaWrelease bugs are among tile most difficult to track down. 
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Op€tiBase RADstudio - ti rapid applicaliori develop' 



meal environmeni for building Jovo'enobled dotobose 
opplicolions. 


Easy Drog & Drop Toots, Intuilive drag ond 
drop GUI building tools and event driven 
OpenScript 4GL occelerote opplicolien develop- 
menl for softwore desigaers oi^d end users alike. 


Instant Deployment. Applications developed 
willi RADstudio ore stored in n central database 
Users nlwoys access tbe latest software versions. 


Scalable Performance. RADstudio is powered 
by OpenBose SQL offering higb-performonce doto 
retrieval and transaction control for demanding 
mufti-user environments. 


^ See RADstudio tocky! 

www.openbose.com/RAD OreNBAsiE 


Ijsting 4: .Safe and unsafe usage of retain and release. The 
final version using autorelease avoids a memory' leak if 
an exception is raised before release. Tliis safety comes at 
a performance and memory cost. 

(void) unsiife 
t 

NSTiiBelntervfll seconds Per Day ^ 7Ji * (iQ * 60: 

KSDate* keptDate = [duteKeeper datf*]; 

NSD^te ’totDorrow = 

fNSDate dateWlthTitaeintervulSincrNowtfSf'ronclEPerDay] : 
if {[ki^prDatft conpare:tomraorrow] NSOrdcredA.-irc^fidlng) 

( 

NSOriLc* new!>at<»=0: 

[da t oKtrepo r serUati!: t omo r row] : 

// may be tleaJlfHeil 

newDate'= [keptDate luLcrriate: [NSDate datel ]: 

/y and tJic pixij^iii may enish 

[self do$oinethiTig:nEwDat4?|: 

I 

1 

- (void) fiafe 

I 

NSTimaInterval secaudaPerDay - 26 * 60 * 60; 

NSDate* keptDate = [ [dateKeeper dare] retain}: 

NSDate •tomorrow - 

[MSDate datetfithTinffiintervalSInceMowisecondsPerDayJ: 
If (fkeptDate compare:tommorrow) ” NSOrdcredAsoenHiag) 

I 

US Da L.e * np.wDate=0; 

[dateKeeper selDatc:tomorrow); 
newDate^fkepiDato latarDate: [NSDate datejj; 
iaelf doSoinetliiag^newnaieJ: 

1 

[keptDate release ]; 


(void) reallySafe 

I 

NSTiracInterval secondsPerDay ^26 * 60 * 60: 

NSOate" keplOate fffdateKeeper date] retain] autorcleaae]; 
NSDaie * tomorrow ^ 

[NSBate dateWi rhTiineInrervalSince!{o¥:secondaPerUay]: 
If ([keptDate compare:Lomraorrow] NSOrderedAecendiag) 

[ 

NSDate’ rvewDate= 0 : 

[dfit.fiKeeper setDate:tomorrow]: 
newDaTe=fkeptDate iaterDate:[NSDate dale]]: 

[:.*eir doSoineThing:newDate|; 

} 

1 


Distributed Objects 

A highly useful pan of Fcujnclauon is DistributecI Objects. 
I )bt lib LI ted Ohject.s givers objects in different tasks and ih reads a 
t’onvenieni way of comniunicatkvn. 

Tlie most importanr parts ii( Distributed Objects are 
NSC Connect ion, whkrh encapsulates the coinmunicalion channel, 
and NSDistaniOhjeci, which acts as a snind in, ora proxy, for an 
object that lives on the other side of a connection, forwarding 
messages and handling returned values. A connection c:an be 
named, which makes it available to other applicaliiKts on the 
syslen, or anonymous, whicli makes it useful for private 
channels, such as t>etween threads in an application. 
Communicrilion with distihutetl nhjecis is ilircad safe. 
Distributed Obiecls also works over networks, but the seniantics 
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for this have changed because of die kernel change in Mac Of> 
X, and it is not yet clear how named objeci services will work. 

Creating and connecting to a conneaion is very ejLsy, as 
you can see from listing 5- 

Listing 5: Vending an object, and connecting to an abject 
asing Distributed Objects 

(void) connect 
I 

USDiE t antObj ec t * serve rObJ ec t= 

{NSConnection 

rootPtoxyForConnec tlonWithKegister edName iS^’flySer ver" 

host; 

I 

' [NS Conne c tion *) c r eat eCon n ec tionName:E NS St ring *)name 

I 

NSConnectlon* nevConnection=[[NSConnection alloc] inil]; 
if (f ne^iCoo ti ec t ion t egi s te rName: #" name " ]) 

( 

[iiewConnection setRootObjacti self ]: 

else 

[ 

fnewConnection release ]: 
n6wConnectioEi"iiil; 

I 

return neuConnection; 

1 

Extensions to the Foufidation 

Tlie OmniGroup has a set of highly useful foundation level 
frameworks that faciliUiies networking, among tidier things. 
You’ll find more infomuitlon afxjut the frameworks and the 
license at <http://vvww.onnnigroupxom>. 

MPWFoundation From Marcel Weiher of MeUiobject GmbH 
Is particularly interesting; it offers some useful extensions for 
higher order programming. For example, the code in listing 2 
can Ix' reduced to: 

- (void)coolerMethod 
I 

[[(soraeObject lotsOfObjectB] do] doSomething]: 

MPWKoundation is not only u.seful, it’s source code is 
suggested reading for any Cocoa developer. It and an XML parser 
are available at <http://www.metaobjea.com/downloads/Objective' 
G0bjeaive-XML-O.l.s.tar.gz>. Bodi frameworks are mentionware; 
you liave Lo give credit if you use them. 

^rhe MiscKit (<http://WWW.misckit,Com>), a community project 
managed by Don Yacktman, includes MiscFoundation, which 
extends the Foundation framework. The MiscKit was a useful 
resource on NEXTSTEP* but has remained in early beta state on 
OptmStep/Cocoa for several years. The MiscKit Ls governed by 
tile MiscKit license. 

Sen:te has created OCUnit* and Objective-C version of tJie 
Kent Beck's Smalltalk testing framework. OCUnit is higlily 
recommended for developers tliat value integrated resting support. 
You can find (XUnit at <http://www.sente.ch/software/ocunit>. 

A framework called ConcreteProtocol, that exploits the 
Objec:tive-C aintime to give a kind of multiple inheritance based 
on prottxols, and a kit for software Iiceasing, LiceasingKit can 
be downloaded from I'oastedMarshmallow.corn at 


<http://www.loastedmarshmallow.comx The UcensingKit is 
mentionware, and the ConcreteProtocol framework is 
mention ware for freeware developers, and commercial for 
commercial developers. 

There is also a commercial framework for software licensing 
called the Licenser Kit from Stone Design 
C<http://www.stone.com>) and Caffeine software. 

AppiJCATtoiv Krr 

The AppKit is the part of CxKim that is responsible for die 
graphical user interface, Founded on the dynamit^ aspea of 
Objective-C, tlie kit greatly simplifies the task of creating a user 
interface. In the AppKit you’l! find support for drawing, document 
based applications, a laige collection of usefirl interface 
components. The Application kit contains over 1(X) dass^ and 
protocols, which makes it imptjssible to describe it in its entirely 
here. Instead scane of the more interesting classes will be de.scribed. 

NSView and NSCeO 

Whenever there is drawing, there is an NSView. Every 
window cc^ntains at least one view. A view can have a niimbef 
of sub views, each which can have subviews in its turn. 

Views are also where user interaaion takes place. A mouse 
click in a window that Isn't direcily handled by the window itself 
will get .sent to the highest level view in the window at the point 
of the click, as a mouscDown: message. 

NSTextView is a very useful class for displaying text. It has 
support for fonts and pictures, as well a fair amount of layout 
support. Wliilc it may not suffice for a word processor, il is 
asually more than enough for text entry in other appliaitions. 

An NSCeil can be regarded as a lighiwcighi view class, but 
in fact it is an objeci that you draw in a view. Unlike a view* a 
cell does not have a axirdinate system of its own, or any 
knowledge of its position. Tlie cell Ls just a representation of 
some data that can Ik drawn. The cells have a number of 
advantages over views; It is faster to draw many cells in a single 
view than to draw imny views, cells need less memory and they 
can more readily Ik reused. The drawback is ifiai it is more 
difficult to set up drawing of a tx^lL Since the cell dcKsn't know 
wiiere to draw itself, or in what cix^ndinate system, you kive to 
set everything up yourself. 

One useful cell clxss is NSImageCell, which composites an 
image to draw itself. 

Mostly, ceils are used with existing cla.sses with 
composition. For example, NSMatrix displays a set of NSCells In 
a matrix, and NSTableView displays a set of cells as a table. 
Using your own cell classes witli iliese is Utvial. 

NSlmage and NSImageRep 

NSTmage and NShmtgeRep provide a powerful system for 
coinpasitiog and drawing. Before Quartz, one of die image 
representations was NSEPSTmageKep, which allowed you to 
draw EP.S (Encapsulated Postscript) into a view. With Quartz, 
one may expect an NSPDFImageRep instead, Inc essence, all 
you need to do to add support For a new image format in Cocoa 
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(fi to create the proper sutKlass of NSImageKep; ilie display 
system in NSlmage is responsible for selecting tlie proper 
representation ftjr each image. 

The NSCustomlmageRep class is interesting, because 
instead of knowing how to draw itself, it calls a delegate objea 
which does tlic drawing. By using this class, you can easily 
make images draw just abr.>ut any data, and by combining iltis 
with NSlmageCell, you can get custom drawing in any object 
tliat supports cells. 

NSImage Ls a container for image representations. To increase 
pcrfomiance, NSImage will cache a representation, so tfie actual 
drawing code is only executed the first lime die image is 
compo-siied. However, an NSImage will use a cache only if it fils 
the [^solution and colorspat:e of ilie view where it is drawn. Tills 
easures that printed grapliics get the highest resolution possible. 

INSBezierPath and NSAffineTransforni 

NSBezierPath is the class for advanced drawing in Cocoa, 
llie advantages of using NSBezierPath instead of discrete drawing 
comijiands are that you can create llie NSBezierPath once and 
tlien draw ir over and over, which cleans up your code, and that 
you c'an apply iraasfonTis to a bezier path lx:fore drawing it. While 
you can apply a transform to the view where the graphic is drawn 
to achieve the same effect witli disaete commands, diis is more 
casdy if the grapliics needs to be redrawn, since die caiculatioas 
involved in die transformation have to be done each time the 
graphic ls drawn. With NSBezierPath, the Iransfonnation is 
applied only once* since it affeas the drawing commands in the 
bezier palli ratlier tliiin the canvas. 

NSAffine'l'ransform is die transform class of Qx:oa. Tlie fact 
that the transform is affine means that lines that are parallel 
l^efore the transform are parallel after the traasform also. Thus, 
it does not attempt to do tfirce dimensional transforms such as 
perspective. However, this is a limitation of Quartz, not of 
Ctxxra; you can create your own irarLsform classes and apply 
diem to NSBezierPaths. 

Extensions to the ApfKjt 

The Omni Group has some application level frameworks, 
some of whic:h are very rich. 

The GraphicKit, a scruaured graphics framework, is 
available for lieta testing at <http://www.toastedmarshmsllQW.com>. 

finally, the MiscKit's application framework includes several 
useful componenLs. 

Enterprise Objects Framewcirk 

F.nterprise Objeas is a set of frameworks for database 
access and display of database data. EOF insulates from the 
paniculars of databases; die same program can be used with any 
diitab^ise for winch you have a datalrase adapter. Thus, a 
developer can write software tliat is essentially database 
independent. EOF uses die Entity-Association (also known as 
Hntiry-Relaiion) model of databases, which makes database 
modeling very convenient, but maps this onto a relational 
database model, allowing the use of relational database servers. 


such as Oracle and Sybase. Since EOF maps to a relational 
mtxlel, you can build applications for existing databases without 
having to convert die old data to a new format 

Enterprise Objects can be used in server programs, as well 
as in applications. Whenever you need persistent storage of 
large amounts of data, EOF is an excellent c'andidate. 

Cocoa PRociRAMMiNG Techniques 
In Cocoa, you1l find dial you can increase your productivity 
sigoificandy by not programming; with pnKredural APIs, you'll 
spend 20% of your time searching libraries, and 80% typing and 
debugging code. In Cocoa, you spend 20% of your time 
programming and debugging, 30% searching the frameworks, 
and 50^i enjoying your newly found spare time. 

However, sometimes you really must write some new 
code^ and for those CK'cassions, I'd like to point to a number 
of programming techniques thui are highly efficient in 
Objective-C and Cocoa. Some of these methods should be 
well known to programmers skilled in C++, but Objective-C 
has a dynamic dimension which C++ lacks, which affects the 
chtjice of design patterns. 

Inheritance 

Inlicritance is the abused workhorse of object oriented 
programming. Tf you look at the Cocoa APIs, you'll find that 
inheritance plays a significant role in die design of the AppKir, but 
i.s used sparingly in Foundation. Tills Ls done because inlicritance 




automation 

ftCI Automation offers home automation solutions that meel your present 
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creates dependencies bclween ohjects^ breaking the 
encapsulalkin. When inheritance is used, changes to a 
class may break its subclasses. Thus, use inlierirance 
wlicn the kits pt)int yt>u to that method; NSView is an 
example t)f this. Don’t use it where it is clear that Apple 
wants to hide llie deiatls, as with the class clusters. 

Posiiig 

Posing is useful when you need to refine the behavior 
of an object, and cannot use a category. It is a rather 
crude method, and in my opinion sliould only be restjrted 
to for debugging, and when no other met hod suffices. 

Categories 

Categories allow you to add methods to an existing 
cla.ss without siibclas.sing. 'I'he advantage of this is tliat it 
allows modularity of design — different parts of an 
object‘s functionality can be kept in different files and 
frameworks — and that extensions to a class becomes 
ubiquitous, iwery in.stance of ihe class will have die new 
methods, as will every instance of its sub classes. 

Categories twerrtde existing mclltods — unless the 
developer takes pains U) avoid it. This has llie advantage 
that you can replace malfunctioning methods in existing 
classes without liaving access to the source. It is also a 
danger, l^cause you can at'ckienially override a method 
— a pixjbiem which is accenUiaied by the lack of name 
spaces in Objective-C. 

Protoc€>ls 

Proiocois ciefine interfaces without specifying an 
impiementation, Tiii.s allows the compiler and runtime to 
do type checking based on the interface rather than on 
tile class fiierarchy. Protocols are useful when there is 
functionality that can be implemented in many completely 
independent w^ays, and in some cases wiiere multiple 
inheritance would othenvrse l>e needed. 

Whenever an object uses a delegate, ii is wise to have a 
protoca)! that defines what delegates must lie able do. This 
allows llie compiler to w^irn tlie developer if the wrong 
objeci is used as a delegate, and it allow's ihe develo|>er to 
in.scn runfime checks of prutot'ol conformance. 

Protocols arc alst? very tisefiil with Distributed 
Olijects, since you can use protocols to limit the 
capabilities that an ofijeca advertises over a connection, 
and also to do valkhty chei'king on the sending side 
rather than on the receivijig side, which decreases 
comm t mi cations and increases perftni nance. 

Composition, forwarding and delegates 

Composition means combining the oipabilities of 
many t:lasses into one by creating an object that contains 
several olhcr objects and delegates parts of its 
responsibility to tliem. Composition can be n.sed as a 
replac:ement for multiple inheritance, but is far more 


general llian that. 'Ibe great advantage of com]X>sition over 
inheritance is dial it t:an provide shorter and more general 
cixie. A simple example is glyphs; iastead of creating a 
sulxlass for each possible glyph, you create a general 
glyph class, and use comptisition to gel the attributes you 
want. I.e. you don't create a TimesRonianCilyph, 
TimesKomanBoklGlyph, f lelveLic:aGlyph and st> foitii, but 
have a character glyph class on whicfi you composite font, 
color and any oilier aLlributes. lb generalize further, you 
may w^ani to create an Glyph Attribute class or [irottxol, 
such that Font conforms to the GlypliAurrbute prottxol, or 
Glyph Font Is a subclass of Glyph Attribute. By doing this 
carefully, a CharacterGlypli simply iiecomes a diaracier 
and a list of attributes, llie CliaraclerGlyph itself has no 
need to know the particulars of the allributcs, since diey 
provide a common [ntcrface. 

Some advocates of com[K>sition t:latm.s that it should 
replace inheritance completely, since it avoids problems 
slk:Ii as fragile base classes, and is more flexilile. The 
drawback of composition is ilial it creaie.s an additional 
layer of indirection, which decreases [XTformance. 

To facilitate composition, NSObject provides a 
[tieihod called forwardlnvocaiion:. When you send an 
objeci a message that it doesnl implement, instead of 
causing an enor, forward Invocation: will lx called, giving 
you a chance to pass tlie [uessage on kj another object, 

DelegaLes are used in a sjxcial form of composilkin. 
An object hands over a part of its I'unctionality to a 
delegate object, allowing customization without 
subclassing. A text oliject may let the delegate ins^X'Ci the 
incoming text and do completion or speil checking on it, 
for example. An object can also let its delegate observe 
and decide over certaiii iKdiaviours. As an example rT this 
pattern, NSWindtiw uses a deiegate with w hicli it confirms 
that it is OK to peifonn certain actions, .such as dosing. 

OllSERVrRS AND NOi IHCATION.S 

An observer is an olriject that tracks changes to 
otlier objects. Since an ol)jecl is not allowed to look at 
the internals of other objects, this must be 
implemented by liavtng ihe observed ol^jeci inform its 
ol)scrver of clianges through notifications. Htiwever, 
tliis would mean that the observed oliject wanild have 
to he aw'are of all observers, creating unnecessary 
iniertlependence between objeci designs. To avoid 
this, an notilii'ation center acts as a br{?adcasting 
station for notifications. Hie use of a notification 
center means tliat the noriher no longer has to be 
aware t)f its observers. Tilts is liighly useful, hecau.se it 
decouples tlie observed trbject from die observer, 
allowing many different oliservers to monitor an object 
wiihoLiL any changes to the object itself. Encapsulaiitm 
is maintained, since it is the object titai decides w’hen 
to send notifications, all hough it has no control over 
who will receive it. 
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The Ffnindution Kit provides a notification 
broadcaKiing fiiciiity, NSNoiificaiionCenter, to which you 
can send notification objects, NSNotification instances. 
When a notifi<:aLi<)n center receives a notification, it 
inspects it, and send it to alt objects that have registered 
as observers for this kind of ttutification. 

Many classes in the Applit:aiion kit utilize 
notifications. Fur example, an NSWindow will send 
noiifications when its status changes, such as when it 
is moved, sent to anotlier screen, hec:nmes the main 
window, and so forth. By observing such changes, 
otlier parts of the user interface can properly reflect 
tlic status of windows, 

'I'he difference between delegates and observers is 
that a delegate is much closer to the observed object; 
the object knows about its delegate and actively 
delegates resptmsibility to it, 

Singletons 

Singletons are classes that only have one instance. 
When you try' to allocate nK>re objects of such a class, 
you get the same objeci back. This is useful wlien you 
allocate an immutable object with the same data 
repeatedly. Ftxr example, in a word processor where 
you represent each glyph with an object, youTe likely 
to have a lot of instances of the letter 'e’ in your default 
font. Then, instead having one copy of the glyph for 
each time it appears in ilie text, you have multiple 
references to the .same glyph instance, saving an 
immense amount of memory. Of ctxurse, this means 
that the glyph cannot have a notion of position, hut 
that is probably a good design choice in a word 
processor anyway. 

The Model View CfintroUer paradigm 

'I'he Model View Controller, or MVC, paradigm has 
been in the toolbox of object oriented programmers for 
over two decade.s. The central idea of this paradigm is 
breaking an application, or subsy.stem into three parts; 
the model, which represents the data in your 
application, the view, winch is the visualization of that 
data, and the conlroller, which manages the other 
objects, sucli as by taking user input on the view and 
translating that to changes in the iiiodek 

'file MVC paradigm is a high level design pattern, 
and you may have many classes in each category in an 
application. 

The great advantage of the MVC paradigm is that it 
separates ilie data storage code from the display code 
and the user interface code, making it relatively easy to 
cieate a new user interface for an application. Thus, you can oeate 
a %veb based inierface for a cfcitaba-se application, while sharing the 
diiiabase cxjcle witii the Aqua interface, for example. 


Instead of running around your house 

run your house with this. 


Levltnn's Touchscreen Decora llmnc ControJ center uses 
advanced graphics interface technology to take the mystery 
out of iiome automation. The 
result: total control over 
lighting, heating, appliances 
and much mure, all from a 
system as easy to use as a 
telephone. Simply plug the 
touchscreen into an electri¬ 
cal outlet and control 
Levitan's acclaimed line of 
DHC switches, dimmers, 
receptacles, thermostats, 
and more. It's an automation 

system that's as easy to add as it is to use, because it uses 
the existing electrical wiring as a command network without 
any special wiring* 
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Hanging around galleries and 
iiiuSeUITlS could give an ordinary 
lighting control delusions of grandeur. 

Fortunately, Levllon's Monet™ 
dimmer Is no ardlnary Lighting 
control. It's a work of art in Itself, 
designed to associate with some of 
the best* Designed for use in show- 
rooms, gaileries and museums, this 
architectural s peclfication-grade 
dimmer is now showing in selected 
home environments as well. Fre- 
programmable scene control and 
all-digital circuitry can call up the 
right mood for romance or the best 
background for home lliealer. Most 
important, Monet’s beauty is more 
than skin deep. It's a direct descen¬ 
dant of the Leviton professional 
lighting controls proven in years of 
demanding commercial use* 
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"Pile Ccxx:)a appliaiLion kit is extrenicmly suiliihle for MVC 
pr(jgrammin>>, and the dtxumcru sLipport in Ctxtxi follows the MVC 
pi^radigm. Tlicre is an Apple arUde called Application Design for 
ScTipting, L)cx.\in)enLs. and Undo'- tliai explains lliLs cToneept hirther, 
[<htlp://deveEoper,apple.com/te(hpubs/macosx^ 


rx^elopment tools 

Cxx:o£i development Is txmtered an)und Pn>jc‘<tBiiikkT, an 
application whidi lets you edit and cTuaie files, which iniinagc^ the 
compiler, and inleracis with InterfaceBuiidcr to ki you create user 
interfaces for y{)ur applitalions. Interface Builder is a fully ohjea 
oriented user interface design application built on a palette niodel of 
components. 

Another pan of iJic tool suite Is EOModeler, w'ltit'h lets you 
LTeule Enterprise Ohjeas data Ixtse nKxlels, Ytxi can drag database 
objects fojni ROMcxieler to [nterfaccBiiikkM- to quickly create user 
interfac'es for datalxtsc applications. 


ProjectBuiJkltT 

Project Builder lias always been a relatively simple 
integrated development environment and a foir ainoum of 
complaints alK>ur it lias been heard from Mat intosh develofxrs 
that are convening to OPENSTER NeXf was a small company 
and didn’t have the rest>urces to perfect every pan c>f the 
develo|XT environment, hut wiili Apple s significantly greater 
resources, the rougli edges of ProjectBuilder,should lx.' polished 
off before the release of Mac OS X, 



fi^ff re /, A fresh fmmeimrk praject in Pfr^jeclBuilcier 


ProjectBuilder utilizes adapted versions cominon Ick>1s to 
do mucli of its job; it uses tfie Gnu C Compiler (gec), 
gnu make and the Gnu debugger igdh). The use of these 
Hiols is hidden in a varying degree; get and gnumake live 
quietly in the background, while the user has to interact 
directly witii the tidxigger to use the full power of gdb. 

Despite its faults ITojeciBuilder does an acceptable job 
even in its pre-X state, and its indexing and formatting 
functitms for Objective-C code are (luile good. Extensions lo 
PrtjjectBuilder provkle word completion and other features, 

lNTKRlAavBtIIU)KR 

When 1 llrsl tried to learn NextStep development ]>ack in 
199^, Interfacelkiildcr wu.s by far the greatest hurdle I ran 
into; the ctmeeptuai step from tradiiuinal procedural user 
interface development to InterfaceBuilder's pure object 
motlel was simply too great, li took over a month before I 
figured out that you couldn't undenstand how' NextStep 
pfogiams work by looking at the code, you had to look at 
the (‘onnections between objects, and that those connection 
livetl in the interface binarie,s. 

In InlerfaceHiiilder, you create user interfaces by 
dragging and dropping components from palettes, by 
instantiating control and motlel objects, by creating 
ctmnections between csbjects and l>y the setting objects' 
instance variab[e,s. Figure 2 shows how the target of a 
bulUm tilled ‘‘Done" is a)nnected to the liccnseDonc: 
method of the object called “Aj>f)Delegate'\ (Naming the 
objects is not neces,sary, InterfaceBuilder will create a default 
naine based f>n the t)bject’s class, but tt is a ctjiivenient way 
of dtxuriienijng the interface.) 
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fi^urv Z Connecting a hutlon to an action 
in inUfr/ace Builder 


Unlike n^tany GUI buildm, Imed'aceBuiJder ckxrs noi create code, 
iasiL*ad it aeaies an iniciface ck^Tiption, in Mac OS X this will he ,savtxl 
as an XML file. T!ic interface description is a complete pittiire c>f the st*Ue 
of tht^ d)jccts in tlie user interface — st>metinies refeted U> ;is Freeze 
dried oi)jects. 


Cx)niponent palettes 

Willi a small effort , any user interface object cm be turned into a 
palette, but For hkH applicatioas the jxdettes tliai a>mc wiili 
InterfaceBuilder are sitfiicient. 

Once you have an d}\M as a aimponent of a jxilette, you don't 
need to create a new palette for subciLLsses; l>y using the “atsiofn class" 
inspector, you can tell interlace liuikler to use any sul^ lass of the [lalette 
component. This is pix)perty is set for each iasrance, ratlier tliat for each 
cliiss, which means tiiat you'ie can use a scp^imtc custom class for each 
bunon in your interfac’e, should the need ai^. (If it docs arise, you’ie 
likely to be lietter off by asing aampt^iiitin than by Hulxlaf^mg. hut 
InterfaceBuilder ckx-sn’t force you to follow ilmt a[>prt)achd 

Apple is likely lo refine InterfaceBuilder tlie final leltuse, Ixit 
the palette oigiinization fn)rn OPENS'!'KP 42 gives ai least an idei of 
what we can expect. 

Tlie menu palette gives you easy access to the defauli Qxxra menu 
stmaure. By simply dragging Uie dtxument menu {)nLo die menu bar, 
you get the exact menu struoure tliat Apple's user interface guidelines 
reaimmend. Custom menus can lie cieated with the "iLaiT and 
“Submenu'' ccaiiponents. 



Figure i The Metiu Paletie 


The SiOW6St connection on this 
QuickPort™ wallpiate is more than 
150 tilTIGS faster than your modem. 


Want the right infrastruiiure for 
tomorrow's information arict cHJier- 
tainment technologies? Invest in a 
Leviton Structured Media* system 
today. Our Xtreme"* Jack can move 
over lUO floppy disks worth of data 
every second at speeds nearly 
20,n00 limes faster than the fastest 
rnotlems. while QtiickPort optical 
fiber txjiijiectors deliver giga-speed 
access to the future. No matter 
where technology takes you, your 
Leviton Structured Media systein 
wilJ always look at home in your 
home. It's part of Leviton's Decora 
system, the desigji standard for 
architectural-quality control and 
wiring devices. 



^int^^ated 

aejijst tjoe of (fie 
ime^fat€d Sokjtxim for System 
Des^nefs. fixmore nfbrmatibn 
orfftecofTipi?(enso^ 
contact tewtoi ln*esg?afed SoMms 
at {300} $17-0190 emm im 


O 193ft Lflviicri M&milactufmg Co . Ifw * www.lovlton.cwn 
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A CdiiitefUi Wf^rU 


Why would dliyono want a power 
outlet that looks like this? 


Because it's a lot lictter than seeing 
red after an unexpected power!inc 
surge turns your comjnilcr or 
liome theater system into an 
expensive pile of junk. This Leviton 
Surge-Protected outlet is designed 
for applications where power 
quality is mission-critical. Wliy plug 
your home office or iiome theater 
into anything less? Especially when 
this professional-grade protection 
is also a genuine part of Leviton 
Deetjra, the design standard for 
architectural-quality control and 
wiring devices (yes, it's available in 
white an<l ivory along with fire- 
engine red). 





leviton $u(]goProteaed ootiets m just 
one of Uie ^novations iifi /iHfEsg^ared 
system Des^iefS. 
ftr mote ififoffnatofl or t/io comptete 
tesDuflce on contact 
IfiMton inte^aiotl SoMidns af 
fBOOjSZrmsOedensjbr) 789. 


O iftftft LffvttDfT Manufacturi^ Co,. Inc. - www.ioviion.com 
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Tile view palette contains most of the day to day 
inredaee coHi[K>nencs; sliders, l^yttons, text fields, radio 
btittons, color well and drop down nienii, as well as a 
CnsttimView component which is used lo represent any 
SLil^class of NSViewc By using this component, you avoid 
having to create a new palette for each new view class. 




The DataView Palelte 


Creating object instances 

For objects that don’t exist in palettes, you c:an create 
instances from InterfaceBuildeTs class browser This is 
intended for control and model objccLs, objea that sui^port 
tlte user interface, but don’t provide direct user interaction. 


The Vieu) Palette 

The window palette provides a panel conipt>nenl and a 
window c^omponent. Panels are intended to Ix^ Lrsed for 
.supptat dutities, while window^s are the primary user 
interface coinjx>nent. 



777e Windotv Palette 

The DataView palette gives access to the text view, with 
support for ]>lainLext, KIV and fTTML, as well as to the image 
view and to tile dale and n tun her forma tters, which can be 
used with display cells to provide proper fonnatiing of diUes 
and numbers, with localization support. 


EOModeler 

Since Enterprise Objects uses the Entity-Assocaation 
model of dataliases, EOModeler is used to create an 
enterprise model from an existing relational database mcxleh 
or to create an enterprise model, from which EOModeler 
eremites the relational dataliase model. 
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The sooner you find that last bug 
the sooner you can ship, 
and the sooner you can sleep. 


Find these and other essential developer tools at i 


)EP0T. 


^ 3 0^3 i. - i-j sD _ 

only $189! 

"Automatic Debugging" on the Macintosh. 
Easy to use^ Spotlight can automatically 
Find run time bugs in your code without 
your having to change one line of your code. Nail down 
random bugs immediately. Ever dereference the wrong 
pointer? Ever pass the wrong value to a toolbox command 
or over write an array? Your compiler often lets the code 
compile fine and you may not find that bug until you've 
burned it into CD-ROM or released it to the net. Find the 
bugs now, kill them easily, get to sleep sooner. 


liiii >21 J ^ . 

only $79! 

“rtie only llimg more frustrating tfrat bugs, is 
bug reports. Users will send in ^erytbing 
from war and peace to "it crashed/' Buglink 
Solo let's you define what information you want in a bug 
report, then include a customized BugReporter application with 
your application. Users simply click open the reporter, fill in the 
boxes, and click send. The report is transparently sent to the 
email address you defined. Buglink can login into that eMail 
account, download each report, and present you with an orga* 
nized, complete, description of each bug. Great for shareware 
developers, system administrators, and web developers! 




only $39,951 


Every doctor knows, the secret is listening to the patient. The most frustrating part about debugging on Macintosh is you can't "prinlf" 
to show the state of a variable or position in your code, DCon let's your code to talk to you. This system extension adds a console 
window and file fogging services to Mocinlosh and can be used io record and display status and debugging information during 
development. It can be called from virtually any code, any where at any time - even from interrupt handlers, I/O completion rou¬ 
tines, VBL tasks, deferred tasks, and morel DCon does not allocate memory in any Mac developers debugging arsenal. 

www.clevdepot.com 


PO Box 5200 WesHoke Village, CA 91359-5200 • Voice: 800/MACDEV-I (800/622-3381) 
Outside us/Canada: 805/494-9797 • Fax; 805/494-9798 • Email: orders@devdepot.com 















vsrww;mactech,coiii"''^ ' ' “^ 




In Pr»9'«2S2.9' 


P.O. Box &200, Westlflko ViHage, CA 9'I3S9-S200 
Voice SOO/MACDEV-1 * Fax S05/49A^979S 
Email: orders^mactech.com 
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liOAfock4!cr)i {iiagmiu view of a daUihme tmKk*l 

KnkTpdst* Olijccts is also ihc hast* For WchOhjetls, and 
a lull cxpioraiion of its ptjssihilitius vvoiikl HU many volumes. 

Further Re4ding 

'rhere are eurrently very Few books on Oh'cku A 
ilerent substilule is “NeX1‘STEP Programming, Step One: 
Ol^jctl Ortenietl A]>plica!ions" l>y Simson GarFinkel and 
■Michael Mafjoney, which is based on NeXTS'l’EP rather 


than Cocoa, but will give an intrntluclion to the concepts 
ot dynamic t>bjeti oriented programming, and to many oF 
the ideas in Cocoa, 

• Apple provides some good documentation in their 
devek)pcr section, under 

<http://deve[operappleTom/techpubs/macosx/macosx.html>. 
Panicularly iniere.sling are “Object-Oriented 
Pr<}gra mm ing and the Object ive-C Language", 
“OPENSTEP Development Tools it Techniques" and 
the articles under “Programming Topics". The 
reFerences for Pound at ion and AppKit arc alst) 
suggested reading. 

* The Objecrive-C runiijne sysltan is part of the Darwin 
project at <http://pubI[csource.apptexom>, and is a great help 
when y£)u need to work witii the kiwest levels of 
()i>jective-C, extending the language itself 

* CiNUstcp, a free implementation iT the OpenStep 
specillcaiion is under progre,s,s at <htip://www.gnustep.orgx 
llie .sources sIkhiIcI he helpFul to anyone wanting to 
understand llie internals oF C(KX>a. 

• SlepWise (<http://www.Stepwtse.com>) has an article lil>rary 

with many interesting articles on NEXTSTEP, OPENSTEP 
and Cakoi} programming. IQ 


60 


Ho r Ci icx:ouTi:l 


MacTecfi • May 2000 






































































NETWORK 

MANACEMENT 


By John C. Welch 


Seybold for Admins 


A Network 

Administrator's Eye View 
of Seyfhold Boston 


OVFRVIEVt' 

SeybokI is an interesting show for 
a network administrator. Considering 
the main focus of tire show is 
publishing and graphics, both online 
and print, initially it seems that there 
is not much for the IS-rypc other tlian 
free demos and oilier souvenirs. But, 
also consider that many of the 
products shown at Seyhold are 
designed to he on a network, or 
function as servers, and an admin’s 
need to be there is suddenly a lit tie 
more obvious. I had two main 
purposes at Seybold Boston 2000. 'I'ht^ 
first was to see how many vendors 
were really making products that fit 
well into a network, as opposed to 
those that merely work on one. The 
second wavS to kH>k for products that 
would make my life as an admin, and 
by extension the profes.sk>n:il lives of 
you readers easier in some way. 

StYBOLD IN General 

Comparing Seyl'K)lcl if) MacWiJild, 
the most obvious difference is size. 
Seylx)ld lends to l>e much smaller, hut 
tills is to lie expected, it's a more 
fcx'used conference. Another difference 
is in the bofjih pcrstmnel 1 found mut h 


more of a delay at Styhfild in getting the leclinkal experts tor 
a company or booth than at MacWorkf In one case, getting 
my question answered required finding a different conifxiny 
on a different llfxx. This gets tiring quif'kiy, liientlly as well as 
figuratively. Another issue for first - time Seylxjkl attendees is 
fl<X)r organi/ 4 iik)n. Seylx>kl is smaller, but, (to me at least), 
seems noi as well organised as MacWorld, and I llnd that 
keeping tile program is an absolute necessity ttj hnti specific 
btxJths without walking both floors. 

Other than those few‘ admiitetlly picayune issues, 
Seylxjld Is like any other tnule .show, hig, colorful, and loud* 
There are a gexx! numl>er of vendfxs tliere, and if it deals 
with publishing in any remote w'ay, its jirohahly at Seybold. 
Muc h has Ix'cn made of Apple's absence from thi.s year’s 
Seylxild Boston. From a llcxx jK>iin of view, it wasn't as iiig 
a deal as some made it tnit to lx\ 'I'he space that Apple Wfxjld 
iiave used was taken over by other vendors quite well, and 
Adobe seemed to be pleased witit its undisputed status as the 
Big Vendor of the sluw. 

NirrvtoRK Support 

* I here are a lot of .servers, and network enabled 
products at Seybold. JTom prim scitlts to document 
eontroh to security, the pyl>li.sliing industry is well- 
net worked. Hut I his is tjnly frtnn the user viewpf>ini. As an 
adniinisiraLor, 1 was consistently disappointed in the 
almost total luck of administrative support in these server 
products. With few exceptions, when I woukl ask, “How 
does the .sei-ver tel me, the admini.stnUor, know that it Is 
having a problem?”, there would be a few minute.s f)f 
huddled discussion, and then I would get variatton.s of 
“The users will call you”, or “Its very^ reltaf)le, that 
shoukink l>e a problem”. Well, unrortunaiely, waiting for 
someone to notice a (Titical [)icce of software is no longer 
functional is not a trption in a networked environment. 
Especially in the case of multiple sites, waiting for user 
input cun delay problem resolution by liours, and day.s. 


John Welch <jwdch®acr.com> is the M:k‘ and t^C Adminisiralor Ibr AEH Inc\, a weatlier and alniospherit sciern'e t'ornpiiny 
in Caint)ridge, Mass, He has over fifteen years of exix-rience al Jiiaking omipLilers work. His sixn bliies arc flgtiring out ways 
to make the Mac do wfyai ixjfxxly thinks it can, anti si lowing tliat the Mac Ls the superior atlininlsinniv t! plaifurm. 
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Oni" of the rods thiti IS managers get applied to their 
hacks Ls the proacUve rcxl. It is no longer enough to respond 
to trouble reports. Nowadays, we need to L>e notified of 
problems the very microsecond it occurs. Whedier viii 
SNMPl t>r email, or instant message, netwt)rk administrators 
need to know i^efore die user that a server is down. As well, 
if a given piece of liardware is running multiple seiver 
applications, administrators need to know' ihai server 
application A is dead, l>ut B and C are fine. These are not 
minor issties to administrators. Ixit they are almost unknown 
to many of ill esc vendors. 

' rhis is not to say that none of the vendors are aware 
of this. Quite a few are at least including email tiodficadon 
abilities of errors. 'Ibis is a good start, but I would still 
push for SNMP inclusion. The reason is, SNMP operates at 
a low'er level than the application. Tlierefore, it can catch 
errors tliai ihe applicatitui may be unaw^are of, or take a 
wliile to notice. As well, via the traj) mechanism, you can 
set up the app to notify a given management server of an 
error, and the server can tlien decide if it needs to notify 
anyone based on the error seventy. The SNMP standard is 
well docuniented, and used by many vendors including 
Oracle, Microsoft, Apple, and Sun, a.s a way of impit>ving 
the network fit f>f their products. I would close thi.s section 
by pointing out that if 1 have a choice between two similar 
.server/networkable applications, of .similar quality and 
feature set, but one has good error notification support, 
and the other doesn't, the one that makes my job easier 
will win. even at a subsianiially higher co.si. 

pRoniTcnrs of Non- 

Again, although most of .Seylx:>kl Is not specifically 
iargeie<l to the network administrator, there were siane 
products iliat matle me perk up a little. The first one isn't a 
product as much as it is a serv'ice. Sprockets, 
<http://www.sproclcets.com> is a company providing online 
project management services. 'I'he service is based on 
Oracle, and uses a [>er [iroject and a traffic [pricing model For 
charges. What caught my eye alioui sf>rockels thcxigh, was 
how much ptjiential it has. By basing charges on Ixmtiwkith 
urilization, instead of the number of users, Sprcxkeis allows 
a yiroject to be limited by u,se, instead of users. For a multi- 
company/mulii-national project, since there is no physical 
location to a Sprocket - based project, other than the Web, 
tlic traditional problems of distribution and alUx^ation of 
resources are greatly reduced, possibly eliminated. Ihe re is 
also less reliance on a particular piece of cquij>ment or 
location, as the Sj^rockets site handles storage and 
maintenance. Sinc e Sprockets is based on Oracle on Solans, 
not only is it scalaljle to as high a degree as you need, but 
it is also highly Hexible, and can handle almost any user 
requirements. Interviews with the Sprockets staff also 
sliowed that they arc vtry aware of security issue.s, and 
understand the need to lx: proactive in protecting user data. 
They also went out of their way to inform me tliat they are 


.sensitive to the confidentiality of user data, and under no 
circutiistances would they u,se that data as a marketing tool. 
Considering die confidentiality debacles that have arisen on 
other web sites, this is an excellent attiaide, I see Sf^icxkeis 
as being on the leading edge of what \ c'ali kSTs, or Resource 
Solution Providers. They really aren't providing you with an 
application, but rather witli the infrastructure and resources 
you need to use the applications and capabilities you 
already have. To my mind, this is more along die lines of 
w'hat the Web should \yc. 

Anotlter product that impres.sed me was MassTransit, 
from Group Logic Inc., <http://www.grouplogiC-Com>. 
Mas,s'rransit is basically a combination of intelligent file 
routing and AppleScript folder Actions. The whole 
purpose of MassTransit is to make getting files from a to 
/, Willi all stops in between a process with intelligence 
lichind it, rather than relying on users to manually do it. 
The MassTransit server^ creates drop folders that users can 
mount on their desktops as remote drive.s. Files placed in 
that folder are then acted on t>y a number of rules, based 
on die needs for the task that file relates to. What makes 
this better than folder actions is two - fold, first off, the 
Folder can be do.sed, and still have intelligence beliind it, 
unlike folder actions that require the folder to he open to 
function. This is due to the rules being [mjcessed on the 
server, not the end slalion(s). Secondly, the actions are a 
combination of choices from a list and AppleScript, rather 
than .solely AppleScdpi like folder Actions are. Since the 
rules are processed on the server, you rmly need to create 
diem once, rather than replicating AppleScripts to 
possibly hundreds of machines. This also means the client 
machines don’t need to be acting as servers, so your 
re.sotirce usage is nuire cffK'ieni. By creating canned 
actions, stK'li as “Kmail on copy error'", “Kmail files from x 
to z", and combining them with AppleScripls, you get 
tjuick initial functionality with as much tlexihility as you 
would ever need, for companies trying to deal with the 
pnihlems of document routing and approval, MassTransit 
is a wonhw'hile look. 

Tliere were also many t>ther useful admin products, 
and trend lowartls making security a pari of document 
control, especially wiili Acrobat PDFs that should make an 
adiHinistrart>r quite happy. 

CoNOursiocv 

As w i i h a n y ol h e r s ho w, Se y bol d is ex a ct I y a s u sefu I a s 
you make it. Even though it sometimes took longer than I 
would have liked, 1 was always able to gel the answers I 
needed. Unfortunately, the publishing industry ts only just 
starting to comprehend the need for communicaiing .status 
in ways that don't involve having users on the phone 
screaming at tech support. 1 am hoping that next year, 
Seybold Boston %vill have more produc'is Ehat are 
administratively as friendly as they are user friendly. ffi 
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FROM THE 
FACTORY FLOOR 


By Joe Hayden and Mat! Henderson, Metrou>erks, all rights reserved 


CodeWamor for Mac OS X 


CodeW;Vrrior for Macintosh, 
Release 6 

What's going on wUh Rekase 6? 

Joe: A lot? Since the CodeWamor 

Release 5-3 Update went out in 
r^ecemberj we have been working 
fu 11'Steam on Kelease 6, This is going 
to be our best and most stable 
release to date, and we expect to 
ship the product this Summer. Til go 
througli some of the new Features 
below, the main one being targeting 
and hosting on Mac OS X, Apple has 
built a great OS and we are extilcd 
to be providing the tools that the 
Mac developer coiiiinunity will he 
using to target iL 

I DR 4A will be a Cartxmized PBF 
application. It will run on any Mac 
OS supj)oning the Carbon Lib 
extension (currently Mac: OS 8/1J. On 
Mac OS X the IDL will have the new' 
Aqua look and Feel. Under Mac OS 
8.1 - 9, it will retain the Classic Mac 
OS interface. 

A new iDR Tea lure enhances 
Preference Panels, allowing you to 
import and export to and from XML. 
We are adding a new Shielded 
Folders panel that gives the ability to 
S[)ecify whic'h files and folders are 


skipped during certain operations. Previously, this was 
accomplished by enclosing the folder name with 
parentheses. The Shielded Folders panel will let you belter 
define the rype of operation hjr which a given folder 
should Ix.^ shielded. For example, you may want to skip a 
folder for a build, but include it for a file compare 
t>pera!ion. lliis feature will help you meet that demand. 
We've also added new controls to the Source Tree and File 
Mappings panels thai make working with iliern more 
intuitive. In addition, the Remove Object Code dialog will 
have an option to rectirse sub-projecis. 

The new Debugger will support single machine debugging 
on Mac OS X as well as remote debugging to X. There will 
also lie new panels and a new LI] for belter remote 
debugging support in general. 

MSI has been Carbonized. The SiouxWASTK text engine 
has been u[)dalcd in WAS'l'K 2.0 For use with Carbon. 
Other changes since ilie Release 5.3 Update include new' 
hasli containers and vector classes and further 
reorganizaiiDn to clean up the increasing number of 
shared libraries. Multi-largel projects will replace MSL 
Build libraries, w'hich are being moved to an Obsolete 
folder. Scripts will be available to load and build the 
common liliranes from the IDF. 

An updated Carbonized PoweiKlant, CarlKinized Profiler, 
and Carbonized Power?lanf Constructor with Aqua 
interface wall be included in the new release. 

What about Mach-0 support? 

Matt: Apple has told us that Mach-0 is the prerferred 

object file format for Mac OS X, and Ct>deWarrior will 


Joe Hayden is iJie Pnxluci Engineering Manager lor Qx-leWarrior on llie Macintoslu He .sfxjnds his time developing eflldeni 
ways lo clelivLT large software products like CodeWan ior. Wriie to him at jliayden^nicirDWcrk.s.com. 

Matt Henderson is a senior engineer on the CodeWarrior IDE team and Technical tjead for Code^)i^arrk>r Mac OS X ttx>ls. 
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supporf ir fully- Already, weVe released preliminary 
versifms of our PowerPC C/C++ compiler and linker that 
can build Mach'O executables. These tools arc available 
on CodeWarrior for Mac Release 5, and will be updated 
on Keiease 6. However, they will remain in ihe pre^ 
release folder in this release. 

Our Mach-O compiler is, of course, based on the satiie 
C/C++ front-end and PowerPC optimizer that our PEF 
tools have been using for years. Thus, developers who 
need to build Mach-O versions of their products can 
expect tile same high level of language conformance and 
code quality that oor existing Mac compiler provides. 

Likewise, PowerPlant and MSL have been fully 
Carbonized, so developers can use them to build Mach-O 
applications without difficulty. 

The IDE does not yet suppon debttgging MucIvO 
executables, but it will. There are still a number of low- 
level issues to w'ork evut regarding our dehiigger and 
Madi-O, and weVe already started* You can expect to see 
full Mach-O debugging support for CodeWarrior in a 
future release. 

At WWDC this month, we'll be providing a road map for 
our CodeWarrior for Mac products. This wnll include 
details on our Mach-O support. 

What do you think about Mac OS X and Aqua? 

Matt: As a company, Metrowerks is ecstatic alxjut Mac OS 

X. IPs amazingly powerful, ifs beautiftjl to k»ok at, and best 
yet, it's going to ship. To N>rrow' a phrase, IPs “tn.sanely 
great," and we can't wail until Mac OS X is everywhere. 

A lot of us at Metrowerks rememl)er what it was like just 
after Apple introduced the PowerPC, and that's the level 
of excitement that Mac OS X has bnjught to us. We love 
to watch Apple push the OS envelope, and weVe going to 
help tliem do that by enal>hng Mac developers to get tlieir 
products onto OS X as quickly and easily as possible. 

As for Aqua, Pm responsible for a lot of the IDE's user 
interface, so I've been thinking about it a lot. Like most 
everyone else, we had no idea that Aqua was on its way. 
The first time that I saw it was on Apple's web site during 
MacWorld Expo in January. I was stunned, and more than 
a little skeptical. Since then, Pve had llie opportunity to 
use and work with Aqua, and it's completely won me 
over* What's most impressive about Atpia is not what's 
new^ and different, but how familiar it feels. It's very 
obvious tliat Mac OS X is Mac OS, and 1 think that it’s a 


great triumph for Apple's Aqua designers that they’ve 
created an interface lhaPs at once astonishingly innovative 
and also completely comfortable. 

WhaPs going on with MPTP? 

Joe: MPTP is alive and well, Tlicrc have been .some 

changes, including a new administrator, and it is taking a 
little lime to get things running as smoothly as before. 
There was some concern ahoui a message that went oui 
in February about the MPTP server being temporarily 
unavailable, I'hls w'as due to some minor changes being 
made to our network and it was liack up a short time 
later. Unhjrtunately, we didn'i follow up with a message 
intlicaiing that the ser\^ice was resumed, causing some 
people to think we may discontinue MFIT, Hits is 
certainly not the case. In fact, by the time this is 
pi lb I is lied, most if not all Release 6 components should be 
available from MI*TP. 

What is the future of CodeWarrior for Macintosh? 

Matt: Since Metrowerks is now part of Motorola's 

Seniiconduclur Product Sector (SPS) and Api)le is 
MtKoriila SPS's largest customer, CfxleW'arrior for Mac OS 
will contmue to be top priority for Metrowerks. 'Phe vast 
majority of software for Mac OS is created with 
CodeWarrior, so the bencllLs of CodeWarriiir for Mac OS 
lo Mohirola SPS arc oinious. 

With Release 6, you'll sec us take care of all the basics for 
Mac OS X development. After that, weTc going Ut work 
hard to make sure that developers can fully exploit the 
power of Mac OS X. In particuiar, we plan to rapidly 
incorporate .support for new Mac OS X lechnologies into 
PowerPlani. Expect lo see PowerPiant classes for Apple’s 
new Carbon Events API, the CoreEaundation APIs, the 
Data Browser API, pre-emptive threading, and the Quartz 
graphics APIs. 

Likewise, weTe .still liard at work on tin; rest of our Mac 
tools. WeVe improving Java support fur Mac OS, anti full 
Java support for Mac OS X is on tlie way. Now that the IDE 
has made the transition to Carbon, you can expect many 
new and cck>1 IDE features. And of course, we never let up 
on our compilers. We continue to work hard on C/C++ 
language conformanc^e and PowerPC cotie generation. 

So, the future of CodeWarrior for Mac OS has never been 
brighter. CodeWarrior wa.s there for you when you needed 
to move to PowerPC, it's here for you now to move to 
Mac OS X, and it will be there in the future as Mae OS 
continues to grow' and become more powerful* B 
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QUICKTIME 

TOOLKIT 


hy Tim Monroe 


In and Out 


Using QuickTime’s Movie 
Importers and Exporters 


iNTRODLfCnON 

In ilic previous QuickTime Toolkit 
article, we lcK>ked at graphics importers 
and exporters, which allow us to read >stxll 
inwgcs from files, draw ihtxse images, and 
save die images in new image formats. In 
iliis article, we're going tti utke a look at 
movie importers and exptirtens, which 
allow us tt> convert various kinds of data 
lo and from the QuickTime movie format. 
A movie importer reads data and converts 
it into a QuickTime movie, and a movie 
exporter writes QuickTime movie data in 
some other format For example, we can 
use a movie importer to read an AVI file 
and convert it into the QuickTime movie 
format. At that we can display the 

movie in a window and attach a movie 
controller to tt exaaly as if the original 
data had Ix^en stored in the QuickTime file 
format. Conversely, we can use a movie 
exiXJrter to save QuickTime movie data as 
an AVI file. Beaiuse movie importers and 
exporters allow us lo change the format of 
movie data, they are also called mmne 
data exchange compommts. 

Originally, movie imporiers and 
exporters were mainly intended to read 
and write data stored in files that are not 
QuickTime files. We can, however, use 
movie data exchange compiments for 
other purposes also, in particular, we 


can use movie exporters to change the compression format or 
compression settings of a QuickTime file. We can also use 
movie exporters to add hint tracks to a movie so that the 
movie can fie streamed over a network. In this case, the 
existing movie data isn't actually being converted to some 
otlier format; rather, new tracks are being added to the movie 
to enable the movie data U> be efficiently lirokcn up into 
packets that can lie sent out over a network. 

In this article, well begin by considering how to export a 
movie umier a new formal. We’ll see how to do this in two 
ways, first allowing the u.ser lo select any available export 
format and then restricting the export fnrmar to a particular 
formal. Next well investigate how to import non-movie files as 
movies. Finally, well learn liow to use movie progress 
functiom, whicli the Movie Toollxjx calls when an openitkjn 
(such as importing or exporting a movieJ jiromises to take a 
significant amount of time. 

Exporting Movuls 

To a movie is to conven it into a new formal or to 

change the movie data in some other way. QuickTime provides 
a numix’f of Funtiions tliat w-e can use to export a movie. By far 
the easiest to tise is tile ConvertMovieToRle funcLion, whose 
declaration (in Movies.h> looks essentially like tliisi 

OSErr ConvartHovleToFile ( 


Movie 

theliDvie, 

Track 

onlyTrack, 

FSSpec • 

outputFile 

OSType 

flleTypfi, 

OSTypp 

creator, 

SertptCade 

sscrlptTag, 

fibori * 

rt^sTO. 

lang 

flag!.*. 

CojDponen tl n s t a nee 

unerComp); 


Most of lliese paramefeni have preUy obvious uses: theMovie, of 
course, Ls die movie we want to export, and outpulHIe points to a 
file system specification For the file we want the converted movie 
data to iic put into, 'file filelype and creator parameters are the 


Tim Mortrtx" Ims worked at Apj>le for over Id years, first as a technical writer in Uie Inside Macintosh group and later as a 
software engineer in the Quick lime grf Jup. Cuirenlly he is developing sjnnple code anti utililies for the QuickTime software 
developinent kit. You can tOKh him at mtjnroe^apple.eom. 
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dfsired file type and file iTeator code of die declination file, and 
scriptTag ic the script into wiiicli the movie should lx: convened, 

A few of these parameters arc less obvious. ITie onfyTrack 
pani meter specifies wliit h track in the .source movie is to be 
converted; well always specify NULL for tliis parameter to have 
ConvertMovieToFile convert tracks in the movie. The resID 
pan meter |x>ints to some storage that will rctreive the resource 
to of the source movie; wc won't need this infonnation, so once 
again well always pass NULL for this parameter. 

'I’he userComp parameter specifics which movie export 
component should lx: used to perform the data conversion. If 
we want the movie to Ixf exported into a specific format we can 
open the apprtipriate movie export component and [>ax> the 
compfinent instance in this parameter. On die other hand, if we 
want to display a dialog lx>x that allows the user in .select the 
desired output format, then we can paxs NULL in this parameter 
In that case, we should also specify 0 in the fileType parameter 
(since of course we don't yel know what the file type of the 
output file should be), 

lanaliy, tlic flags parameter s^x^cifics a 32-bit value whose 
biLs encode information govt^ning how the movie conversion 
should i>r(x:eed. Our first cxaMijile of using ConvertMovieToFile 
w'ill use this line of <<Kle to configure the flags parameter: 

myFlags = creatoMoviiiFiiEDeletftCiirFilf* | 
showUaerSettingsDialog | 
movieFiieSpecVflild | 
noviEToFileOnlyRxport: 

The createMovieFileDeleteCurRIe flag tells ConvertMovieToFile to 
delete any existing file specified by the outputFile parameter The 
showUserSettingsDialog flag indicates ihal ConvertMovieToRle 
should display a movie export dialog fx)x. .sljowo in Figure 1. 


movieToFileOnlyExpon flag indicates dial the user should lx; 
allowed to selea only from among rhe output formaLs supported 
by any available movie exjxin components, Ttiesc available 
formats are listed in the pop-up menu shown in Figure 2. On the 
other hand, if showUserSettingsDialog i.s .set but the 
movieToFileOnlyExport flag is clear, and if fileType i,s either 
MovieFileType or 0, then the pop-up menu also includes items that 
allow the user to save the movie as a movie File or as a self- 
contained movie file. 


v' Mouie to BUI 
Moule to BMP 
Mouie to DU Stream 
Mouie to FLC 
Mouie to Hinted Mouie 
Mouie to image Sequence 
Mouie to Picture 
Mouie to QuickTime Mouie 
Sound to fliFF 
Sound to System 7 Sound 
Sound to lilaue 
Sound to jiLaiu 


Figure Z 'fhepcp~tip murm listing the formats. 

Figure 2 shows the export formats built into QuickTime 
4.1. Of course, since movie exporters are components, 
addititmal exporters can be added by third parties. So the 
pop-up menu on your machine might contain a few mure 
exporters than you ,see in Figure 2. 



Figure 7he mome dialog fxfx. 

If the showUserSettingsDialog flag is set, then the 
movieFileSpeeValid flag indicates dun the name specified in rhe 
name field of die file .system specification pciinted to by the 
outputRle pammeter .should lx: the name initially displayed in the 
export dialog lx>x. Also, if showUsarSettingsDialog Ls set, then the 


Converting to Any Available Export Format 

Listing J shows u tiincrion QTDX_ExportMovieAsAnyTypeRle 
[\m configures ihc movie export flags and then calls 
ConvertMovieToFile to allow die user to export a movie into any 
available export format. 


Listing 1: Exporting a movie as a user-selected ty^pe 


Q‘llJX_liAptmJWcn 1 ciAsAnyT>ycIitc 

OSErr QTDX_ExportMovifiA‘jAnyiypeFile (Movie tbeMovle* FSSpec 

'thoFSSpec) 

f 

FSSpec myFSSpec = ‘tieFESpec; 

lon^^ tnyFlaas • OL: 

OSErr inyErr * noErr: 

myFlags “ creareMovleFileDeleteCurFiie | 
showUserSettingsDialog ( 
novleFltcSpecVaXid | 
ftovlsToFlleOnlyExport; 


// export the movie inio a file 
myErr - ConvertMovieToFile( 
theMovie. 

HULL. 

SniyFSSpec. 

01, 

F0UE_CBAH_C0DE(^ TVOD'). 
suSystemScript, 

NUT/l. 
tnyFlags, 

NULL); 


// the movjc to eonven 
// all tniek> in the movie 
// the output file 
// the output file type 
// the output file creator 
// the script 

// no tesouree ID to be returned 
// export fhp 

fi no specific export compouent 
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return(RiyErr): 

I 

Because ihe showUserSettings Dialog flag is se[, 
ConverlMovieToFile displays the aiovic export dialog box 
shown in Figure 1. When the user selects an output file and 
export format, ConvertMovieToFile creaLcs that file (first 
deleting it if it already exists) and performs the desired 
conversion. Note that when ConvertMovieToFile completes, ii 
returns information about tlie newly-creaied file in die 
myFSSpec parameter (This behavior appears to be 
undocumented.) In our sample application, the IheFFSpoc 
parameter pa.sscd to QTDX_ExportMovieAsAnyTypeFile points to 
the file system specification of the open movie file. St> we 
make a local copy of that specification in myFSSpec to avoid 
overwriting the movie's file inft>rmatiDn, 

Converting to a Specific Export Format 

As 1 mentioned earlier, we can specify a particular naovie 
export component when calling ConvertMovieToFile if wc want 
to export a movie into a specific format. Let's suppose that we 
want to allow the user to add a hint Entck to a movie, so that 
it can be efficiently streamed across a network. The first thing 
we need to do is find the movie hinter export component. We 
can use the Component Manager functions FindNextComponent 
and OpenComponent to find that component and open an 
instance of it, like this: 

Comp one nr Description KiyCompDeEC; 

myCorapDesc . rromponentiypo ” MovieExportType: 

myCompDesc.roniponentSubTypc * KovieFiieTypc; 

myConpDeso. componeatMatiuf ac Liirer » F0UR_CHAR_C0DE (* hint *); 

atyCompDesc, component Flags = Os 

myCompDesc.coinponenrFlagsIlask = 0: 

my Ex po rt er ^ OpenCotnpon an t (F indS e x t Component t IWiX. 

&iiiyConipDepc)) i 

As you can see, weVe asking for a movie export component that 
can create movie files with fracLs of type 'hinf. Well pass 
myExporter as the last parameter when w^e trail 
ConverlMovieToRle. 

Now, whai flags should we pass to ConvertMovieToFile? 
We cenainly want to pass createMovieFileDeleteCurFrle and 
movieFileSpecValid. And we certainly don't want U> pass 
movieToFileOnlyExport, because we already know what kind of 
output file want to create. Rut what about 

showUserSettingsDialog? Do we want to display the movie 
export dialog box shown in Figure 1? For some purposes we 
might, but for the moment let's suppose that we don’t want 
the user to change the output file name or location (which he 
or she could do if we displayed the movie export dialog box). 
So we won't include showUserSettingsDialog in the flags we 
pass to ConvertMovieToFile. 

Now we've got a slight problem. Wliile we don’t want the 
user to change llie output file name or locarion, we might want 
the user to change the sellings used by the movie hinter exj^on 
com|X>nent. If the movie export dialog box were displayed, the 


user could click on die “Options...' button to display the settings 
dialog lx)x shown in Figure J. 

[insert llinterDialog.pct here) 



Figure J* The movie hinter sellings dmhg box. 

Luckily, we can use the movie hinter export comfxmeni directly 
and ask it to display its settings dialog box, by calling the 
MovieExporlDoUserDialog funcikm like this: 

MovieExportDoOBEcDialofttiayExpcirteE* theHovit;. NtlLL. 

0, 0, ^myCancfilled): 
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So at thif^ poior, weVe found the appropriate movie liinter 
export component and displayed its settings dialog box to allow 
the user to select the desired liinter settings. We can finish up by 
calling ConvertMovieToFile, specifying die movie hinter export 
component: 


siyKrr = ConvertMov i cTot'ile { 


theMovle, 

NULL. 

StnyHintedFile. 
KovieFilaTypc» 
F01JILCHAR_CODE£ 'TVOD'), 
emSysteraScript, 

NULL. 
myFlagsj, 
tnyFxporterJ; 


// Llic nMivje to com’crt 
// atl tracks in ihc 
// the mitpuL njc 
// the output liJc t)p<? 

// the output fik creator 
// the script 

// on resource ID to be returned 
// convL-rskm flngs 
// hinter cKjxm conipt ment 


Tf this line of uxle completes successfully, die specified movie 

will have Iwen exported into a hinted movie Pile. 


Using Movie Export iiettmgs 

Imagine now that youVe goi a large number of movie 

files to which you warn lo add hint tracks. Imagine further 
that you want to tise .some .specific non-default settings ft>r 
the liinting. It woukl be tedious to have to open each movie 
file and configure its export settings in the dialog box 
tlisplayed l»y MovieExportDoUserDiatog. lastead, it would be 
belter to configure those settings once, save them 
somewhere, and llien in.struet the movie Iiiuicr export 
component to use tho.se saved settings. 

llie pr<K-e.ssing required to make tliis happen is actually 
rather simple, k-t s suppose that IheFSSpecPtr is a pointer to a 
file sy.siem .specification for a file that contains a saved cxjpy of 
the desired cx|)ortfr .settings. Then we can u,se the function 
QTDX_GetExporterSettingsFromFile defined in Usiing 2 to read 
tlujse .settings and insuill them as the exporter's active seiting.s. 


Listing 2: Reading stored exporter settings 

Ql'DX_GciE^|Xifit'rSt‘ttuigsl'riJniFil(f 
DSErr QTDX. CptExporterSettiaguFroaifiiie 

^ (MovieExponCoiapotient thpExportei:. FSSpecPtr theFSSpeePtr) 

Handle myHnudle "" MULL; 

CojuponinitKeEult myErr = tnfErc; 

myHandle = QTDX RnadlJandleFroniFi leUheFSSpecFtr): 
if (piyHandle =- NULLJ 
^□to bail; 

rayErr = 

No vieHxportSetSetti nguFroioAtorBConi a I tier CtheExport er, 

{QTAtnmContainer) ntyHa nd le): 


bail: 

if (myHandle f“ NULL) 
OisposeHand!e{iiiyHan<IIel; 

return (COSErr)ttiyErr); 


Ihe fund if >u QTDX ReadHandleFromRIe reads the daia in the 
specified file into a handle; there is notliing e.specially interesting 
alK>ui it so we won’t discuss it further. ITie inijKjmtnt fiinaion 
here is MdvieExportSetSettingsFmmAtorriContainer, which takes 


that handle of data, interprets it as an atom container, and uses 
the settings in that atom container as die current settings of the 
specified movie exporter. 

An atom contains is a handle to a block of memory that is 
stmc'turcd in a hierarchical arrangemenr of container atoms 
(which contain other atoms) and leaf atoms (which coniain 
data). In a future article, we'U take a trloser look at the structure 
of atom cfintainers and see how to cremate and parse diem. But 
for die moment, we can remain blissfully ignorant of ttiose 
details. because we can use the function 
MovieExportGetSettlngsAsAtomContainef to create the settings 
atom container. Listing 3 shows our funciion that saves the 
current settings of the specified movie expcjiter into a file. 

Listing 3; Creating stored exporter sellings_ 

QTDX_SavrExpoTtcrSettinfv^nFik’ 

OSErr QTDX_SavEExporterf;eilltigsinFile 

(HovlcEKportCoBiponem theHxporter. FSSpeePtr theFSSpecPtr) 

QTAlomCoEtalner nyContainer * NULL; 

ComponentResult myErr = noErr; 

myErr = MovieExporcGetSetrln&sAsAtomCfintfl !ncr 

(theExporler, krayContainer); 

If (tuyErr no Err) 

^oto bali; 

myErr = QTDX Wr Upland leToFile((Hondie) 

myContainer * thoFSSpeePtr); 

bait: 

if {myCoo til iner 1“ MtILL) 

OTD1s p oseAtomCon t a In e r(myCo n t alne r); 

retum( tOSErr)inyErr); 


So wiiai we need to do i.s tiisplay die mtivie hinter cx|x>rt 
component’s settings dialog Inix once, allows die user to 
configure the hinter settings a.s desired, and then save those 
settings into a Hie by calling OTOX^SaveExporterSettingslnRIe. 
Then, can usc^ iJuxse Siived settings for any sulisetjuent export 
operations. LLsting 4 shows die complete function 
QTDX^ExportMovieAsHintedMovie thar exjxirts a movie as a liinled 
movie. Notice dial this funciion lakes a Bfx>ieiin ]>araine[er that 
indicates whether it should display tlic sellings ciuiog box. 

Listing 4: Exporting a movie as a hinted movie 

Ql’DX_lixp()rtMfJVit*AsHjntcd\1i^vic 

OSErr QTDX. ExportMovleAsHinteclMovle (Movie tbRMovle. Boolean 
theFromptUjjer) 

r 

Conponent Uesc ription 
MovieExportComponent 
long 
FSSpec 
FSSpec 

Boolejiii 
Boolean 
StringPtr 
StrlngPtr 
Compofien tResu 11 

myFlags “ 

createMovieFileUeieteCurFUe | moviaFlleSpetValid; 

ByFrompt 


rayCoBipDesc; 
myExporter ^ NULL; 
myFiags; 
myRintedFlle: 
myPrefsFile: 
rayTeSelected - falne; 
raylsReplaclng = false; 
my Prompt; 
myfiieName; 

myErr - baHComponentType; 
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Qitutii 5 _€onve r tHTijPas ca iS l rin g {kH intedHovieSavc P rampt ): 
uiyFJlfiHftiiie ^ 

ornt i la c&nV er l CToPa s c a 1S t ring (WJ1 n f edMov i e Fil^Ka ibc } i 


// get iiri iHitpul file for Ibc tiuncit movie 

Cn^ranie_FutFlle(myPrompt, rnyFilaName* &iiiyllintefiFlle» 

imylsSelected, fiiniylsReplacing): 

If (!myIsSelected) I 

inyErr = userCaneel PidErr: 
goto ball: 

1 

if (myisKepInning) t 

myErr = FSpDnlatef^inyBiiitedFUe): 
if (inyErr 1= iinErr) 
goto ball: 

I 

// find ami open a movie export eomponeni ilial can hint a movie file 

myComplJeae.coniponentType MovieExpoirtType: 

myCompUesc.cooiponontSubType “ KovieFiieTypc: 

myCompDese, eomponentHaniifac toro r = F0UR_C11AK_C0^E^ ’ bint ‘): 

nyCompDesc teoiftpotifititFlaga ^ 0: 

myCompDefiC.componantFlagsMask = 0: 

say Ex p 0 r t e r Op eiiCoraponent tf indNex l Component {NULL. 

imyCoinpOayc)): 

If (myExporter “ NULL) 
goto ball: 

// gel llM.- preferrnees file for ih^ applkratkm 

CrPOX_G€tPrefsFnfiSpec C£iroyPrersFae, (void * J&myHintedFile); 


// nrad exiMing movie exporter setting's fit>m a file; if we aren't gping m prompt 
// the user for exporter setfingXi these siorcd senings will lie used; cHherwise. 

// these sttjred settings wilt Ix' lesed as initial values in the settings dialog hejx 

QTDXjSelExpocterSettirigsFromFilefmyExporter, ^PreffiFilc): 

If (thePromptUfier £>& QTUX_GomponentHaaUl(NovInExportType. 

myExportar)) I 

Boolean myCaneelled ^ false: 

// displitv' a diaJtJg box to prompt ilie user for desired movie exporter settings 

myKrr HovieExpoetl)oanprDialog(iiiyExportnr, 

theHovle. HULL- 0* 0, SmyCancellcd): 

if (uyCaneelled) 
goto bail; 


) 


if save tlie existing settings tnio our prefenences file 
QTDX SaveExporterSottingelnFiie(myExporter ^ 

tnyPrefsFile): 


// export the movie into a file 
myErr = CoiivcrTMovieToFile{ 
iheKovlfi, 

IfUU- 

imyHintedFile. 
MoviGf’iloType. 
FOUR^CHAK^COHE('TVOD ^), 
BmSyatemE>cript. 

NULL, 
itiyFl ags, 
myExporter): 


//the mov’ic to convert 
if all traeb in the tmwie 
// the ouiptit flic 
// the ontput file type 
// the oii^m flic eitrator 
// lire script 

// no rcsmirce ID to Ire reinmed 
// conversion flags 
// liijiRT export component 


ball; 

// close the mtivie export component 
if (tnyExporter !“ NULL) 

CloseCompon&tit (layExporter): 

freeCmyPrompr): 
freefmyFiieHamo): 

rei:nrii({OSErr)inyErr); 

) 


Importing Files 

An we saw in the previous aiticle, QuickTime ocaLsionally 
imporLs files for us, wiilit>iii our iLiving U> expUcitiy find £i movie 


imfx>rler or oil any fiJe-conversion funclion. When we call 
NewMovieFfomFile and specify a file tlial Lsn't a QuickTime movie 
file, NewMovieFromFile l(H)ks for a movie imptjrter tiiat can handle 
ihe dam in dial file. If i! finds one, ii autonmticaliy uses that 
inijxiiter to t'onven die file dam into the Quicklime nitwie lorrruit 
and reairns die converted movie to us. So we am import files dial 
are not Quicklime tmivie files simply by handing diem to 
NewMovieFromFile and letting it wtirks its magic. 

But dicre are a lew' demil.s we need to take care t>f lielore 
we pass a file to NewMovieFromFile, First, if we want to mimic 
die beliavinr of QuickTime Blayefs "Iinpori,,,’’ menu item, then 
we need to make sure that die list of files displayed to the user 
in the file-selection dialog lx)x dcK^s noi include QuicikTinie 
movie files. We aLso need to make sure that that list ^/riev include 
files of type TEXT and PICT (wliicli by detauk are not listal in 
the file list displaytxl w'hen “Open" is selected liut which are 
displayed when is .selected). 1lien, if we are not 

using the StandardGetFilePreview function to tlispby that list of 
files, we need to determine whether a file selected by the user 
need.s to be converted into another file bt'ldre it can l>e 
imported. Ufs take these two tasks in order 

Filtering Out Movies 

Tlie list of files displayed in respoast? to selecting the 
“Import.,." menu item should not include any files that are 
Quic:kTime movies. If we are u.sing the Navigation Services 
funaion NavGetFile, we am :ict:omplish this by passing it a file 
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filter function that accepts all files that QuickTime can open, 
except files of type kQTFilelypeMovie. Our application 
framework maintains a list of all files tiial Qiitck'llme can open, 
either directly ur using a movie importer or a grapliics importer 
So all our imix)ri file filter function needs to do check to see 
whether a candidate file has a type dial’s in thtt list but that isn't 
kQTFileTypeMovie. The function QTDX.FitterRIes defined in 
Listing 5 dtK*s just that. 

Listing 5: Filtering oul movies _ _ 

QTDX FiiterFilcs 

PASCAL_RTN Boolean QTDX_FtlterJFilefi (AEDefiC ’‘thelteMp void 
"thelnfo, void ^theCal IBaL-kUD. NavFilterModefi theFilterMode) 

I 

#pragnui unuEedttheCallQackUDp theFlUerModeJ 
KavFileOfFolderInfo *ayInfo « 

(NavPileOrPolderlnfo ^JtheTnfo; 

if (gValldFileTypee =■ NUTL) 

QTFramOuiidFileTyppLttJt (] : 

If tlheXtem-ldescripLorType ““ typeFSSj \ 
if (IiaYliifo->isFijlder) I 
OSType iiiyType - 

tuylnfo >fiIeAndfolder. flleinfo,finderTri£o,fdTypej 
long oryCount: 

long mylndex; 

// stT wheilitr the fiif lypc is in Uie lisj i>f file typt's ihai our apptioritm can 

// open bui d(i nor alkw m<wk files 

myCount Got PirSizet (Ptr)gVal IdFileTypesj) / 

Uong)sizoof {OSType); 

for (mylndcx = 0: toy Index < luyCount: Eaylndex++) 

If ((royType ^ gValidFUeTypeslmylndex]} 

CmyType 1- kQTFileTypeMovie)) 

return(true); 

// if wc gurt 10 ticnc^ it’s a flk wc cannot open 
return(falire ); 

\ 

// if wc got ro here, it's :i folder or non liJ'S olijcct 
return Cl rue): 

J 


If we are running on Windows, where we are using the 
StaniLird File Pat:kage. ifs even .simpler. We can ju.st pass 
StandardGetFlfGPreview a list of file tyix's (hai includes ail types 
that QuickTime can ojien, minus kQTFileTypeMovie. When we 
consinicted ilie list of file types gValidFifeTypes, we pul 
kQTFileTypeMovie in die first position. Sf> we can just pass a 
pointer that begins at the second file typL\ like this: 

myTypeListPtr = (QTFraiiipTyppLlacPtr)SgValidFlleTypes[ll: 
myNuniTypon = (short) fGerPtrSizef tPtr)gVal IdFileTypes) / 

eizeoflOSTypt^)) 1: 


You might \ic wondering why we dkln't also use a custom 
file filter function wilh StandardGetFilePreview, On the 
Macintosh, tliis would work fine; but on Windows, only the list 
of file tyi^es is used lo determine which files to sliow in the file¬ 
opening dialog box. 

Importing In Place 

QuickTime can imptm some tyfx^s of files without first 
leaving to make a copy of llie file data. Tliese kinds of files t:an 


be imfmrted in piace — meaning that the associated movie 
importer can construct a movie that directly references that data. 
Other kinds of files cannot be imported in place. For instance, 
when we select QuickTime Player’s “Import,,/ menu item and 
choose a file of type TICT\ we are presented with the dialog 
lx)x shown in Figure 4. which asks us to specify a new file to 
hold die converted piclure data. When we specify a new file, the 
selected 'PICT' file is converted into that file and tlien die 
converted file is opened in a movie windows 


a Meditations 
[ . Eject \ 

f Desktop" ] 

l_Neu>C3^J 


[ OptionsZ^ 

[ Cancel [ 

[ Saue 


4. IIh^ file amrmyion diah}* box. 



Saue conuerted file as: 
I Penguiti,.pct Mouie 


If we are using StandardGetFilePreview to present a list of 
openahle files lo the user, w'c don’t need to know- whether a file 
can be imported in place. StandardGetFilePreview deicrmines this 
by itself and presents the file conversion dialog box whenever 
the selected file cannot lx irnjxmed in place. But if we are using 
the Navigation Services progrjimming interfaces, we do need to 
figure lids out. Listing 6 defines a function that determines 
whetlier a given file am lx imported in place. As you can see, 
we first find a movie importer that c'an open files whose type is 
that of the specified file (on the Macintosh) or whose file 
extension is that of the specified file (on Windows). 'Hien we 
call GetComponentInfo to get a set of flags thai specify the 
capabilities of that imjx>rter. For present purpases. we need to 
see whether the hit canMovieImportInPlace is set. 


Listing 6: Determining whether a file can he imported 
in place 

QTDX_rik-CjitilicJniptifttdTtiPlact' 


Boolean m'DX_FlleGanRoTraparts<lInPlaoi» {FSSpec 'theFSSppr) 
I 


CoiiipoTientBescr 1 p i I on 

Component 

Boolean 

OSIype 

unslpeti long 
OSErr 


my CotnpDesr : 
myComponetit - NULL; 

myCanlraportlnPlace - false; 
mySubType: 
royFlags = 0; 
myErr noErr; 


Ilf TARCKT_0S_HAC 
finfq 


inyFileTn to; 


// tire file type of the spccirusl file 
iiyErr ^ FS^etFlnfo(theFSSpot:, ^nyFilelnfo); 
if (myKrr noErr) 
goto bail: 
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mySubType " myFilelnfo.fdTypci 
if end if 

#if TAKGET_0S_W1N32 

a gtt the frleimnw; extension of the Jipetilled file 

BiyFrr “ OTGetFileNajoeExtension(theFSSpec >najne, 

OL 4 &mySubType): 

if EmyErr f= noErr) 
goto bail; 

myFIags ^ jnuvielmportSubTypeioFlieExtension; 
ilfendif 

ntyCompDese, component Type Movie Import Type: 

myCompOftfic^coBtponentSuijTypo * mySubType; 
myCompOesc.coiiiponentManufacturer = 0 ; 
myCompDesc* component Flags " nty Flags; 
myCompDesc,coinponp.ntFlagsHask ^ inyFlags; 

rayComponent = FindNexrComponent ffJULl . ErmyCompDeac); 
if (myComponent 1 = NUU*) I 

GorComponentlnf 0 {myComponent * fimyCompDesc ^ 

NULL 4 MULL, HOLLh 

if (myCompDesc 4 componentFlags & canHovielmportlnPlace) 
myConTDiportlnPlace true: 

I 

ball: 

return[myCanItnportInPlare); 

\ 


Ijuportlng Files 

Now we liiive all the pieces we need to handle the 
menu item. First we do the necessary work to limii 
llie files displayed in llie file-t)penlng dialog box to any files tlmt 
QuickTime can import but which are not QuickTime movie files. 
Then we check to see wheificr the file selected by llie user can 
Ik* imported in place. If it cannot, we need to display a file¬ 
saving dialog 1 h7x to elicit a new file from the user; we ako need 
lo convert the selected file into a movie file, w'hich we can do 
using the ConvertPileToMovieFile function. Finally, we pass die 
converted file (or the originally selected file, if it can he imf>otted 
in place) to our function QTFrame.OpenMovielnWindow, which in 
turn cails NewMovieFromFile. Listing 7 puis this ail together. 


If (myErr ooErr) 
goto bail; 

myConvertedFile = myFileXoCortvert; 

// deicrniuic whether the selected file iicctls to be converted into atKithcr file heft>re 
// QiuckTtnic cm open it; if so, do the conversion 
#if TARGET_OSJlAC 

if (!QTDX_FiXeGanBeImportedInPlac«t&myfiletoGonvert)) i 

Boolean mytsSclijeted = falser 

Boolean arylsHeplaclng - false; 

// dtspbiy the put-file dultig lo isavt the con^-erted file 

QTF rame_Fot Fi1^(myP romp t, my Fi1eToCo nver t»name, 

SmyConverledFile* fitmylsSelected. ^raylsReplacing): 
if t^mylsSelectod) 
goto bail; 

// delete any existing file of titat name 
if imylsReplacing) 1 

atyErr ^ DeleteMovieFilet&myConverredFileJ; 
if (myErr 1“ noErr) 
goto bail; 

I 

// import the file into a movie 
myEtt * ConvertFileToKovioFllfit 
frmyFileToConverl. 

AmyConvectedFlle4 
F0UR_CHAH_C0DE('TVOD'), 
smSyst-nraScript. 

NULL, 

OL, 

NULL. 

gMovie P rogr ess P r ocUPP. 

OL); 

1 

tfendlf 

// now open die (possibly) converted file in a window 
if (myErr noErr) 

OTFrame OpenMovielnWinduw(NULL. SimyConvertedFlle); 
bail; 

it (myFilcFilterUPP != NULL) 

Dispose Hou 11neDescr1pto r(my F LleFi1terUPP); 

free(myPrompt); 

refurn(myErr); 


// die file to convert 
// the file to convert it into 
// die otttpur file creator 
// the script 


Listing 7; Importing a file 


QTDXJmportAnyNonMovic 


OSErr QTDX_ImportAnyKonMovit? (void) 

t 

QTFcajiieFileFlItorUPF 
QTFrameTypeListPtT 
Ghort 
Movie 
FSSpec 
FSSpoc 
StringPtr 


myFileFllLorUP? = NULL: 
myTypelistPLr = NULL; 
tnyNumTypes 0; 
myHovle NULL; 
myFlloToConvert: 
myConvertedFile: 
myPrompt 


OTJtilF_Canvortr,ToPaacalStrlTig(kliitportSaveFronipt); 
OSErr myErr “ noErr; 


Ilf TAKGET_0S_W1N32 

inyTypeListFtr = CQTFcatBaTypeLiEtPtr)&gVaHdFiieTypaE [IJ; 
inyNumTypes *■ (short) (GetPtrSiza((Ptt)gValidFnnTypes) / 

sizeof(OSType)) * I: 

lendif 


// let tlic user select an iipcnutrie file ftom Afvy files that aren't mfjvtc files 
nyFlieFilterUPP - 

QTFrafflO^GetFileFilterUPF(tProcPtr)QTD]eFilterFiles): 


rayErr “ (JTFrame^GelOneFIleWithPreviewtiiyNiiinTypea. 
inyTypeListPtr. imyFileToConvert. (void •JmyFneFllterUPP): 


It'S important to understand that our Macintosli 
implemeniaLion of the "Import..." menu item lacks a key 
feature provided automatically by StandardGelFilePreview. Tt> 
wit: the file-saving dialog box displayed by the call to 
QTFrame_PutFile in Listing 7 docs not contain an Options 
buiton tliat allows the user to niodily any sellings supported 
by the movie imptjrter capable of opening the selected file. 
(Look again at Figure 4 to see tile Options bulUm provided 
by StandardGetFilePreview.) To add a custom button to the 
standard Navigation Services file-saving dialog box would 
take us too far afield right now. Let’s put this item on our list 
of features to add at some time in the funire. 

DEfAlTLT PlKXlRESS FUNCTIONS 
IJnle,ss a movie is very short, the calculations and disk 
accesvses involved in (for instance) exporting it to a new formal 
can take several mmotes, if not considerably longer, even on 
lodiiy’.s relatively fast machines. From ics very inception, 
QuickTime has provided a way to inform die user that a lengthy 
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OjX'nition is in progress and to provide some indication of how 
much of the operation has completecl 'I'hese tasks are 
accomplished using a mumeprogress ftmciion, which typically 
disf^iays a movie ptrygress dialog ira:. In tiiLs seaion and the 
Following two sections, well see liow to display and manage a 
movie progress diaiog ix)x. 

By far the easiest way to display a progress dialog Lxix is to 
use QuickTime's default progress function, which displays and 
manages a dialog Ixrx like the one sfiown in Figure 5 (on 
Macintosh computers) or Figure 6 (on Windows computers). 


Enpurlmg Houle 

I_i I I Stop 1 


figure 5- Ihe default progress dialog to (Macintmhk 
EKpofting Movie 

mufifTii Stop J 

f'lgiire d Ihe default progress dialog box (Windom), 

As you can see, these dialog boxes contain a progress bar 
control that shows the relative amount t>f completion the 

operation, a text string indicating the o|)cralion that's in 
progress, and a bunon to cancel the operation. There are a 
do7en or so operations that can trigger the display of a movie 
progress dialog lx>x, iriclutfing exfxirting and im|xining movies, 
cutting or [lasting movie segments, loading a movie into 
memory, and saving a movie as a self-ixjntainecl movie. 

You am instrua QuickTime to display this deiauli progress 
dialog lx>x till ring lengthy tiperaiions on a particular movie by 
calling the SetMovieProgressProc function and passing -t as rhe 
progress function iiniversitl procedure pointer. Our ]>asic 
application framework includes this line of code to set the 
default funakm for eacli movie we opcai: 

St*tHoviePro|Sfrf^ssPToc{0iyt1ovie* (HovieProgressUPP) * 1, 0): 

You need to take ihe word “defauli” here with a grain tif salt, 
iKiwever. You'll get this default progress dialog lx>x only if you 
call SetMovieProgressProc with -1 as the seetmd parameter If 
you open a movie, tlfi not call SetMovieProgressProc, and then 
initiate a lengthy o[)eration, QuickTime does not display any 
progress dialog lx)X at all. This might lead tfie user to think that 
your application ha.s frotten, sti its almost always a giKxl idea to 
use a progress fund ion that provides mme visual feedlnick. 


key combination and interprets those presses as equivalent to a 
click on the Slop iiutton. Finally, it displays a inessitge indiailing 
whicli o[>craiion is in progress. Not bad for a single line of ccxle. 

Still, it's templing to wvant to jazz things up a i>iU and 
Quit'kTime provides a way for us to iastall a custom progress 
function liiat is called |x?riodieally during a lengtliy operiirion. 
We're free to do just about an>tlting in oiir ctistom firtigness 
funciion. We c'an display a different dialog box or message, 
replace the progress bar cotitrt)! by some other [xogress indicator, 
play sounds, and the like. For the tnoment, well restrain our urge.s 
to bkxit our progress dialog box with features. Instead, we'll retain 
the basic appearance and o(XTalion of the default progress ciialog 
box, wliile adding two features: well add a text message that 
indicates the approximaie amount of lime remaining in die 
0 [xraiit)n, and w^^ll add a picture that is gradually erased (from 
IxJttom to top) as the operation pnigresses. Figure 7 sliows tnir 
custom progress dialog Ixix In action. 


EKporting Houle 

i: ■ ■ I f Stop I 

Time romttini ng: 41 seconds 


F’i'gfin? 7. The custom progress diak^g Ixix of QllkttaRx. 

As you've already seen, w'e install a custom progress 
fimction by pa.sstng its universal prexedure ptrinicr to the 
SetMovieProgressProc. So, if our custom progress function is 
QTDX_MovieProgressProc, we can lastall it by executing these 
lines of code: 

gHovieProgresKPracUPF • 

NewttovieProgretJsProc EQTDX KovtcFrogressProc); 
if ({* M lifjWindowObject). fMovie != NULL) 

S(*tMt>vJieFrogre®jsProc (t * * LheWindovObject). fHovie* 
gMovicProgressProcUPP, (lurigJtheWindowObjcci); 

Tlie third parameter to SetMovieProgressProc is an arbitrary 
32-bit reference constant that's pas.sed to the movie ])r(>gres,s 
fynclioa each time it’.s called. Here we are passing the window 
object associated with the movie. We don't actually use that 
value in our cu.siom progress fund ion, but it's not liaixl to 
jjnagine things wc could do with that information. 

Our cusiom movie progR^.ss function has this deHaration: 

PASCAL RTN OSErr QTDXJovieProgrtfijEProc 

{Movie theMovie. nhort theKessage. short theOperation. 

Fixed thePercentDono, long theRefcon); 



Ci rsTOM Prck;rfss f unctions 

The default progre.ss binctbn in fad dc^es a fair atnouni of 
work for us. It dis[>lays the default progress dialog ix>x, 
continually updates the progress bar control in the dialcig Ixjx, 
and res[X)nds tt> user (iidcs on the Slop button. In addilitm, it 
looks for user presses on the F-scape key and Coinmand^period 


As you can see, tliis function lias five parameters, two of winch 
arc the movie Ixang ojKTaled upon and the reference constant 
tlxit we s]:x:cified when we called SetMovieProgressProc. ihe 
theMessage j^araineter is a value that indicates why our f’jrogress 
function is being called. The Movie Tck)11x)X tiefine.s these 
coastants for this parameter: 
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enum f 

movieFrogressOperi * 0, 

movieProgressUfKlatePercent = 1. 

movieProgressClose ^ t 


So our custom progress fuiKlton gets cailletl when ihe Icngiliy 
operation Is sUirtecJ. when rt has stopfx^d, and at various 
[KTcentages of completion. Tfie prt)grcss function is called often 
enough for us to keep our tlialog Ixjx updated in a fairly smooth 
manner, if IheMessage is movieProgressUpdatePercent, then the 
thePercentDone parameter indicates the percentage of 
completion. I'his perteniage is always specihetl as a Fixed value 
between 0,0 and L(J. 

Tlie theOperation parameter is a constant that specifies 
which operation has triggered the custom progress funcritm. The 
Movie TfK^llxJX defines tliese twelve constants: 


enum I 

progresijOpFlaUen l» 

progre«st)ptruiet tTrackSegraent = 2, 
p ro g re ssOp I nsertHtiviO Segment = 3. 

progres^Paste = 4* 

progresEOpAddMovieSeiectiofi 5, 

progreRsOpCopy “ 6» 

pragresnOpCut = /. 

progreHsOpl^adHovielntotai = 8. 

p rog re s sOpLoodT ra r k T ntoRem - 9, 

progressOpLQHdMedlaTntoRatn = 10. 

progressOpImportHovie =11, 

progreEfiOpExportMovle ” 12 


Well use this information to determine which string to display at 
the top t>f our custom progres^s dialog box, like this: 

// set ibt* dialog Ix^x tnct tlta drsalbcs ilic currem operation 
CetDialogUcfftciyDlftlog. kPtogressTfeKtltemlD, 6«iayl LoraKlnt!. 

^myltemHandle, fenylteaRet! l) j 

if ((theOperatioii > 01 

(tbeOperiU Ion C- progressOpExportHovie)) ( 

GetIndSt t ing(my St r iJig, kOpe ra 11onsSt rin gnRfes10. 

iheOperatlt^n): 

SetDia]ogIte«T^xt(myItenHandle. iiySLring); 

I 

Our applicalion's resource file contains a STR#’ rejiource of ID 
kOperationsStrlngsResID tkit contains strings describing each of 
the twelve possible operaiit>ns our movie progress function can 
be called to handle. Wc’ll use the same strings that are used in 
the default progress dialog box. (in faa, T .simply "Ixiirowecr the 
SIR#’ resource of ID -19183 from Uie QuickTime extension.) 

Our custom progress function is in fact fairly simple 
in .structure, if a tad long. U simply insjjecls the 
theMessage parameter to .see what pliase of the operation 
is occurring and ilien switches to the appropriate code to 
handle that phase. When our fiinaion receives the 
movieProgressOpen message, it opens our custom 
progress dialog box and performs any initial 
configuration of the dialog box. When it receives the 
movieProgressUpdatePercent message* it updates the 
progress bar control and erases the appropriate section of 
the picture in the dialog box. During this phase* our 
progress function also looks to see if Uie user wants to 
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cancel the operation. Finally, when it receives the 
movieProgressClose message, it disposes of the dialog 
box and cleans up. Let’s consider each of tliesc phases in 
a bit more detail* 

Opening the Dialog Box 

When our custom progress funaion receives the 
movieProgressOpen message, we’ll open a dialog box in 
the standard way^ by reading it from our rescjurce file: 

myDlalag ” Get^iewDialogtkProgreesDialogReelD, HULL, 
(VindowPtr) l) ; 

If we are successful in opening the dialog box (that Ls, if 
my Dialog is non-NULL), then we need to display the 
appropriate operation message (which we just saw how 
to do) and configure the progress bar control. To 
configure the control, we want to set its minimuni value 
to 0 and its maximum value to some arbitrary value, 
defined by the constant kProgressBarlVlaxValue: 

GetDialcigItem CmyDlalog, kProgressBarItemlD , 

SmylteiiiKind , WylteraHandle , 6cniyItemRect) ; 

myBar = {ControlHandle)isyItemHandle; 
SetControlMinimumCinyBar, D) : 

SetCoi^trolMaximuni CmySar, 

(Sint16)kProgreasBarHaxVfllue)i 

In fact we could probably dispense with calling 
SetControlMinimum and SetControlMaximum here, because 
the minimum and maximum values are set also in the 
resource file; liul it doe,sn't hurt to make sure that those 
values are what we expect them to be. When it comes 
time to update the progress l>ar control, it will be 
imponanl that the control maximum be set correctly. Note 
that we are saving the control handle of the progress bar 
control in the local static variable my Bar. 

Next, we need to set a drawing procedure for the user 
item that contains the progress picture. We can do so like 
this: 

G^tnialogItem(inyDialoj^, kProgressPictureltemlD, 
SniyltemKind , ^myltemHandle . &myItemRect) : 

SeT:DlalogItein{inyDialog, kProgressPictureltemlD, 
myItemKind. (Handle)gProgreesUserltemPrncUPP, 
^myltemRect); 

The global variable gProgressUserliemProcUPP is a 
universal procedure pointer to our function 
QTDX_ProgressBoxUserltemProcedure, which reads the 
picture from a ^PfCT’ resource in our application’s 
resource file and draws it in the rectangle enclosing the 
user item, using the QuickDraw function DrawPicture. 

Now we are ready to display our custom progress 
dialog box tc] the user We’ll call MaeShowWindow and 
DrawDialog to do so. We shall also call the user-item 
drawing procedure directly, since that results in a 


noticeably quicker update of the user item when the box 
is first drawn. 

MaeShowWindow(myDiaiog); 

QTDX^ProgressBoxUserltemProcedureCmyDlalog, 

kProgressPictureltemiD): 

DrawDialog(myDlalog): 

Finally, we’ll call the TlckCount function to get the 
current time, so that we can later display an estimate of 
the remaining time: 

myTicks — TickCountO; 

Handling Progress Messages 

When our custom progress function receives a 
movieProgressUpdatePercent message, tlic thePercentDone 
parameter indicates the percentage of completion. As 
mentioned earlier, tlie value paSvSed in the thePercentDone 
parameter is always between 0 and fixed 1 (that is, 
between 0x00000000 and 0x00010000). just to l>e safe, 
however, we’ll first verify that the value passed to our 
custom progress hmciion lies within die expected range: 

If ((thePercentDone < 0) 1| (thePercentDone > 

fixed1)) 

break: 

Ihe next tiling we want to do is update the progress 
bar control, Remember that tlie acceptable values for that 
control lie between 0 and kProgressBarMaxValue, so we 
need to scale thePercentDone to lie within that range. We 
can do this with die following lines of code. 

if (myBar NULL) 1 
SetControlValue(myBar, 

CSIntl6)Flx2LongCFixMul(thePercentDona. 
Long2FixCkProgressBarMastValue)))) ; 

I 

We also w^ant to erase the appropriate bottom portion 
of the picture in the custom dialog liox. Once again, this 
mainly involve.s sc^aling the height of the picture rectangle 
by the percentage we are passed, as follows: 

GetDialogltemCmyDialog, kProgrei^sPlctur^ItemlD, 
ifinyltemKind, ^myltemHandle, &myItemRect) ; 

MacSetR^etC &inyEraseRect, 

myltemRect.left, 
my11 emRec t.bottom - 

(STntl6)F±x2Long(FiKMul(thePercentDone. 

LongZFix(tsyltemRect-bottom - myltetnRect ♦ top))) . 
myltemRect * ri g.ht * 
myltemRect*bottom): 

EraseRect C&myEraseRect): 

The last visible thing we want to do is print out an 
estimated time remaining in the lengthy operation. In 
QTDX_MovieProgressProc, we retrieve the rectangle 
suiTounding tlie area where we want to draw the 
remaining time estimate and then call the function 
QTDX_EstimateRemainingTime, like diis: 
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GetDiaiogltem(myDiaiog* kProgressTiraelteniID, 
SuuyltemKind * 

11 emHaG d 1 e 1 

&myTtemRect) : 

QTDX^EstimateRenuainingf iroe {fitmy I’temRect» 

thePercentDone * 

TlckCount[) - myTicka): 


QTDX_EstimateRemainingTime is defined in Listing 8. 


Limiting 8: Displaying the estimated time remalnitig 


QTDX_Est i maccRcmainingTiinc 

void QTDX_EstimateReinainingTirae {Rect *tbeRect* Fix^d 
thePercentDone, UInt32 theTlcksElapsed) 

I 

char myString[32l; 

Fixed JtiyE a tTl c ks ; 

UInt32 myRemSecondc; 

Rect myEraseRect r 

StringPtr MyPString = NULL; 

inyEstTicke FixMul (FixDiv( fixed 1 , 

thePercentDone), 
Long2FlJtCtheTlcksElapsed)) : 
myRetnSeconds “ Flx2Long(FlxDiv{inyEstTicks - 
Long2FlxCtheTlcksElapfied), 

Long2FixC60))): 

TextSize CkTimeRemainingLabelSiie); 

TextFont Cl) J 

rnyPStrlTig “ 

QTU111a^Conve rtCToPa a calSt ring CkTimeRemainingLa bel); 

MoveTo(theRect ->left * theRect->bottoiii) ; 
DrawStringCmyPStting); 

MscSetRect C&TiiyEraseRec t * 

theRect‘>left + StringWidth(myPString). 
theRect->top * 
theRect‘>right* 
theRect >bottoiTv) : 

freeCmyPString): 

EraseRectC&ayEraseRect); 

HoveToCmyEcaseRect.left * myEraseRect.bottom); 

// the eariy percentages give Inaccurate estimates, so don't start 
// displaying the 

// time umii wc'vc reached a minimurn threshold 
if {ihePercentDone < kMinimumUsefulPetcent) 
return; 

if (myKemSeconds “ l) 

aprintf (myString. '‘%u second” . myRemSeconds) ; 
else 

sprintf(myStringp ”%u seconds”, myReniSecondH) ; 

myPSt ring “ QTUt11s_Conve r t GToPas c a1St rIng £ mySt ring): 
Drawstring(myPString): 

free{myPString): 

I 


Handling User Actions 

One other thing we need to do in response to the 
movieProgressUpdatePercent message is check to see 
whetiier the user has performed any actions that affect 
any items in our custom progress dialog box. In our case, 
that means that we have to check to see whether tlie user 


has clicked the Stop liutton or pressed an equivalent key 
or key combination. This turns out to l>e a bit tricky. 
Normally, when we are displaying a modal dialog box, we 
can sit in a loop calling the ModalDialog funaion, waiting 
for the user to hit the Stop button {or perform some otlier 
operaiit^n that our mtxlal dialog event filter function will 
map into a click on the Stop button). But we cannot adopt 
that strategy here, because our custcjm pnigress function 
is being called pericxlicaily by the Movie Toolbox, which 
is busy performing some lengthy operation. In other 
words, we're not in charge when we're inside of our 
progress function; rather, the Movie Tooll>ox is allotting us 
some time periodically to update our progress dialog box. 
Since we cannot sit around waiting for the u-ser to 
perform some relevant action, the next best thing we can do 
is go IcKiking for events that interest us w^henever we 
receive a movieProgressUpdatePercent message. For 
instance, we can look for clicks on the Slop button by 
searching the event queue f<ir mouse-down events, like this: 

CetDialogitGm{iiiyDialog, kProgreesStopButtonltemlD* 
^myltemKind * iiinyltemHandle, ^myTtemRect) ; 

if (WaluNexuEveui: (tnDownHaak, ^niyEvGriL* 0, NULL)) I 
GlobalToLocal{&myEvent.where )t 
if [TrackControl C CControlHandle)niyIteraHandie, 

myEvent.where. NULL)) 

myErr ^ userCanceledErr: 

\ 

And we can look for key presses by searching hie event 
queue for keyDown events, like this- 

if (WaitNextEvent{ksyDownMaBk, 4myEvent, 0, HULL)) f 
tuyKey = my Event .message h charCodeHask; 

if (myEvent.modifiers & cmdKey) 
if (IsCmdCharC&myEvent. kPetiod)) 
tnyKey ^ kE sc ape Key; 

If {myKey kEscapeKey) ( 
unsigned long myTicks; 

// simulate a press on the Stop button 
HllireControl((ControlUandle)myTtemBandle* 

kControlButtonPart); 
Delay (kMyButtonDeiay . SrinyTicks) : 

KillteControl C CControlHandle)myIteniHaudle. false) ; 

myErr = userCanceledErr; 

I 

Notice that when we find a click on the Stop button or 
the appropriate key press, we set our function return 
value to userCanceledErr. Whenever our custom progress 
function returns any non-zero value, the Movie Toolbox 
cancels the t)peration in progress. 

Now, this all works fairly well for handling user 
actions. Our progress function i.s called often enough that 
it can pick up these user actions and respond to them just 
about as quickly as if it were continually calling ModalDialog 
inside a loop. There is only one remaining complication: if 
we Rin our applic-ation with this code for our custom 
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progress funclion on Windows, the user's clicks on the Stop 
button will not l>e found when we call WartNextEvent. ('iTiis 
is clue to sc^iTie fairly low-level details of die QuickTime 
Media Liycr whtt^h need not concern us here.) Tlie Escape 
key presses will be found just fine, and all tlie item- 
updating cxxle works just tine. It's just diat clicks on the 
Stop button arc‘ not to lx: found in the event queue. 

'I'he solution to this problem is to in.stall a callback 
prc.xedure that Is executed whenever an event ocxairs for 
one tjf the ai:live trontrol items in the custc>iTi dialog liox. 
Our callback function can he very simple: all it needs to 
do is look for clicks on die Stop button and Uien set a Hag 
to pass that information back to our custom progress 
function. Listing 9 shows our dialog callback function. 

listing 9: Ltniking for clicks on the Stop button on 
Windows 

QTDX_M<>deleii«(:a III wck 

#lf TARaKT_0S_WlN'J2 

f!tatic void q'i'DX_Hod€iessCaiiback (EventRecord 
'LheEvent * 

DlaiogPtr thMlialog, stiort iheltemilit) 

I 

//pragma unused (theEvent, tboOialog) 

if tthtiTlomHit *= kProgressScopStixtonltemlD) 
gtloerCa nee lied = true; 

) 

#t'ridl£ 


Closing the Dialc»g Box 

When the Movie Toc^lbox is finished with the lengthy 
operation that triggered our progress funclion or w-hen it 
receives a non-zero reairn waliie from our progress 
function, it sends our progress function a 
movieProgressClose message. Tliis is tiur signal to remove 
our custom progress dialog box from the screen and do 
any other necessary c:lean-up. Our custom progress 
function executes these few lines to dispose of our dialog 
box and reset the static variables: 

case movieProgresijGlose: 
if (myDlalog MULL) 

DisposeDialog(myDlalog): 

myDialog = NULL; 
myBar " NtJTJ-; 
break: 

So mm we've handled all three messages. Our 
complete progress funclion is shown in Listing 10. 

Listing 10; Displaying and managing a custom 
progress dialog box 

(^niX^MovleProgrcssProc 

PASCAL_RTN OSErr QrDX_MDVieProgrefifiProe (Movie 
theMovle* short theMessage, short theOperation* 

Fixed thePercentDone, long theRefcon) 
f 

//pragma unused (thf^Movia* thoRcifcon) 


Now we need to do two otlier dungs. In the code 
handling lire movieProgressOpen message, we need to 
install this callback procedure and initialize die global 
flag, like this: 

#i± TARGET^OS_WIN32 

SatModelessDislogCs11backProc fmyOlalog, 

(QTMod€»lf^nnCanbackUPPjQTUX_ModelessCallback} ; 

t UserCanr.f!ll(?ri false; 

(‘ndlf 


And then in our code that handles the 
movieProgressUpdatePercent [nesstige, we need to .see 
whether the glofial Hag has Ix^en set by the callback 
procedure; if scj, we set the funcLion return value to some 
non-zero value and then jum]> to the end of the roudne. 

#ir TAHGET_OS_WIN32 

if {gUserCancelled) I 

myErr = userCancelfjdErr; 
goto bail; 

I 

//end if 

If you'd prefer to avoid using global variables here, 
you could instead pass information to and frcun the 
callback procedure by .setting the window reference 
consLani of ihe c'ustom progress dialog box, using the 
SetWRefCon function. 


CG rafPtr 

GDHandlo 

Filatic Dialogftr 

static ControiHandle 

stittic UInt32 

short 

Handle 

Rect 

Rect 

Str?S5 

EventRecord 

char 

OSErr 


mySavedPort = NULL: 
tnySavedOevice “ NULL; 
tnyDialog - NULL; 
myEar - NULL; 
myTicks = 0: 
myTtemKInd: 
EnyTtcraJfaiidle = NULL; 
myllemRect: 
myEraseXect; 
inySt ring; 
myEvent: 
iDyXey: 

myErr = uoErr: 


GetGWorld(&mySavedPort» (temySavcdOcvlce); 
if (inyDialog != NIUJ-) 

SetGf^Torld ((CGrafPt rimy Dialog, GetMainDevice {)) ; 

awItch (ihcMessage) t 
cai^e movieFrogressOpen: 


// the pnjgrcsN dialog b<»x 

myDlalog “ GetUowDialogCkProgrcnaDialogRoslD. NULL. 

(WlfidcjwFtr) 1) ; 

if CmyDiaJag != NULL) 1 


// Ma the dialog box as the eurreiii gn»phies port 
SetGWorld((CGrafPtrJmyDifliog. GetMainDeviceC));; 


SerDialogCancelltem CmyDialog. 

kProgr^^neStopSut tool tetnl n) ; 


// configure the progress bar control 
GetDlaioglLem(riiyDialog* kProgressBarltemlD* 
&myllemKiiid, fiimyltemHandle, &niyItemRect) ; 


myBar = (ControlHandle)inyltemHandle: 
SetControlMinimuraCniyBar * 0): 
SetControlMaxirouinXmyBa r * 

(STnt16)kP rogressbarMaxValue): 


// set the dialog bt>x lexi that describes the cuireiii operation 
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GetDialogItemCmyDialog* kProgressTextItemID, 
fidnyltamKind* ^myltemHandie. ^myltamKect): 
if ( {theOperation > 0) Bl8l 

CiheOpera L t on <= pragresfjOpExpoirtMovie)) I 
GetlridSt ring(mySLring. kOperat ionsSt ri ngsResTD. 

LhoOperatiOft) ; 

SetDialogltemText (tnyltemHatidle * myString) : : 


// set SI ujM.T-itt.'m drawifig procedure Ibr the picture rectangle 
GotDIal ogTtoniCmyDtalog, kProgrRSRPictureltamlD* 
ficRiy I LcmK i rid » ^myTt-emHand 1 e., imyTteniRp.ct-} ; 

SetDialogltem (tnyDialog, 

kProgressPictureltemlD* 
myltemKind. 

(Handle)gProgressUserltemProcUPP. 

Amylr einKpct) ; 

// show the dialog 1 -h>x anti draw the picture in the user item rectangle 
MaeShowWindow (myLHalog) : 

QTDX_Progres sBoxU aerit emF roc edure(myDialog. 

kf rogressPic turel tetnlD) : 
DrawDialog(myDialog); 

myTlckfr = TickCoimt () : 

#il TARGET_OS_WIN32 

// sc't a disdog csdlback procedure, to notify our progress prtK' 
// that tile user hsis cancelled 

SetHodeiessDiaiogCailbackProc(myOialog. 
CQTKodelessCaiibackUPP}QTDX_ModelesaGallback); 

// initiali/;e the variable that keeps track of W'hcthcr the user has cancclJcd 
gUfjerCancel led “ false: 

/jfendi f 

I 

break: 

case tnovieProgressUpdatePercent: 


#if TARGET_OS_WIN32 

it CgUserCaneeiled) I 

myErr = userCanceledErr ; //stop the 

operation goto ball: 

I 

//end if 

// check ti> see whether the user wants to cancel the operation 

ii gel the rectangle surn>uuding the Stop button 
GetDialogIteni{myDialog. kProgressStbpEuttonltemlD, 
fiiMyltemKind. iimyltemHandle, SmyrtetnRect) ; 

// check for user clicks in the Stop hutton 
if (WaitNextEvent CmDownMcLsk. SmyKvenL, 0. WLfLL)) [ 

GlobalToLocaKfitiiiyEveTit .where) r 
if (TrackConrrol((ControiHandle)myItemHandle. 

myEvenr.where. HULL)) 
myErr = userCanceledErr : //stop the oi>eratk>ii 

1 

// check for user piiesses on the Fst'ape key or on eqiiiviUent key 
// combinatiofis 

If (WaitHextEvent CkeyDowTiMaBk, fiimyKveni, 0. HULL)) [ 
myKey = myEvent.message & charCodeMask: 

if (myEvent. modifiers £t cradKey) 
if (TsCmdChar (jfidnyEvent, kPeriod) ) 
myKey = kEfscape^Key: 

if (myRey = kEscapcKey) [ 
unsigned long myTicks: 

// sjtnuJaie a press on die Stop buitoji 
HiliteControl((ControlHandle)myltemHandle» 
kControlBut-tonPart) ; 
Delay (kMyBuilionDelay . &myTlcks) : 

Hi 1 tteConr ml ((Conf rolHandl a) 
myltomUandlc, false); 
myErr = QaerCaiiceledKrr : 

// Slop the operaUon t 
J 
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// tipdutc our pnj-gress dklof; box 
if (myBar !- NULL) I 

// tbcIVn^oitDiTiiE is in tht mtgit 0 to l^xedl (fhtOOOOOOOO to OxfiOO10000); 
// we need to scale it to lie within the range 0 to kPtogressBarMaxValvic 
Se tControlValue{myflar * 

tSIntl6)Fix2LongtFiiMuiCthePercentDooe ^ 
Long2Flx(kProgressBarHaxVfllue))))r 

1 

// VTXix tile apprupriaie bottom portion of the picture 
G^tDlalogltem(myDialog. kProgresnPictu relteuTD * 
ArayTtemKind* irayTtomHandle, &myItc»Rcct}i 
MacSetRectf SmyEraseRect, 
myltemRect,left, 
myItemRect-bottom ’ 

[SIntl6)Fix2LoiigtFixMuiCthePercentDone- 
Long2Fix(myIt€mRect.bottom - rayltemRect.top))). 
myItemRect.rlght, 
myltemRect.bottom); 

E^aseRect{^lII]yE^aseRect) j 

// update the estimated time remaining 

OetOlalogItern(myDlalog♦ kFrogreasTimeItemID- 

StmyltemKind, SmyltemHandie * SmyltemRect); 
QTDX_EstimateRenminlngTime C^tmyltemRect, the Per cent Done , 
TickCountC) ^ myTicks); 

break; 

ceeo movleProgressCloset 
// remove mir progrts^s dialog box 
if CmyDlaiog != NULL) 

DiaposeDialog{myDialog); 
myDialog - NULL; 
myBar - NULL; 
myTlr.kfi ^ 0; 

break; 

J 

bail; 

SatGWotld(mySflvedPort, mySavedDevice); 
returnfmyErr); 

]■ 


Progress Functions For Image Oferations 
So far, weVe focused on implementing ;i custom 
progress function for operaitons involving movies 
(importing, exporting, cutting, pasting, and so forlh). 
But operations on tmages can also take a significant 
amount of time, Ft)r instance, compressing or 
decompressing an image can sometimes Lake t|uiLe a 
while, especially if the compression or decompression 
algoritiim is processor-intensive and the image is fairly 
targe. So we’d like to be able to provide the same son 
of progress notification to the user that we can now 
provide wttli lengthy operations on movies, We can do 
this by defining an ima^e pro^^ress funciion. 

tn general, everything weVe learned so far about 
movie progress functions will be of use in writing an 
image progress function. The declaration of an image 
progress function is slightly different than iliai of a 
movie progress function. Here’s how we might declare 
an image progress function: 

PASCALJTN OSEtr QTDX_liiiagGprogressFroc 
{short theMessage* 

Fixed thePercentDone,, long theRefCon) ; 


upem here). Also, there is no indication of which 
operation is triggering our image progress function. 

The main difference between an image progress 
function and a movie progress function is in the way 
we install tlie progress function. As we've seen, we can 
call SetMovieProgressProc to install a movie progress 
funciion for all lengthy operations involving the 
specified movie. When we call SelMovieProgressProc, 
we need to pass it a universal procedure pointer to tlie 
movie progress function. When installing an image 
progress funciion, htjwever, we instead need to pass 
the address of a structure of type 
ICMProgressProcRecord, which is defined (in 
ImageCompression.h) like this: 

struct ICMProgressProcRecord 1 

ICMProgressUPP progressFroc: 

long progressRefCon: 

): 

Using the ICMProgressProcRecord record, we specify 
both the image progress function and the reference 
constant. For example, we could call 
GraphicslmportSetProgressProc to install an image 
progress function for any image bandied by our 
application like tiiLs: 

If ((**thGWindowObjiict) . fGraphicaljnpQrter NULL) [ 
ICHPtogrestsProcKGcord myProcRec; 

rayProcRec. progressProc ^ gljuageProgressPrtitiUPP; 
luyProcRec . progressRefCon “ {long) theWltidowDb ject; 


GrspbiGsTmpcjr t ScjtProgr^esProc t (' ^ LheWiridoTiiObject) . fGraph 
IcfJitnportGr. &niyProciiec) : 

) 

Al this p<iinr, whenever the graphics impotter 
associated with the image undertakes some lengthy 
operation, it will call our image [irogrcss funciion 
QTDX^ImageProgressProc, (To get the default image 
progress function, pass (ICM ProgressProcRcordPtr)-t as 
the second parameter, in place t)f ^rnyProcRec/J We 
could of course display a custom progress dialog box 
devoted especially to ]mage.s and manage that dialog 
box witli a new image progress function; for simplicity, 
however, we 11 just call our existing movie progress 
function, as shown tn lasting 11. 

Listing 11: Displaying and managing a custom 
progress function 

QTOX_ Image FrogrcssProc 

PASCAL^TN OSErr QTDX.ImageProgreseProc 
(sh&rt theMessage, 

Fixed tbePercontDone. long iheRefCon) 

I 

return(QTDX_HoviePcogressProc(NULL, theMessage, U, 

tbePercenrDone. theRefCon)): 

1 


As you can see, there is no parameter specifying die 
movie (since of course there is no movie being operated 
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Notice thill we pass NULL for the movie parameter 
(which is okay since we never use that parameter in 
the custom movie progress function). We also pass 0 as 
the operation parameter. As I mentioned alxive, our 
custom image progress function does not get notified 
about which operation is taking a long lime; 
accordingly, we just pass 0 to our movie progress 
function as the operation parameter. Since 0 is not a 
valid index in a 'STR#' resource, we won't be able to 
display a custom message telling the user whicli 
operation is in progress. For images, therefore, the 
custom progress dialog box will contain whatever 
message is specified in the dialog item resource (which 
in our ca.se is Making Progress’'). 

This Month’s Code 

'Fhe Code folder accompanying this article contains 
the project files, source code, and resource data of a 
sample application called QTDataEx, for both 
Macintosh and Windows. QTDataFx i.s just like our 
basic QTShell application, except that the Test menu 
has Ix'cn renamed ‘'Movie'' and includes three items 
chat illustrate basic uses of movie data exchange 
components. Figure 8 shows the Movie menu of 
QTDataEx when a QuickTime movie is in the 
frontmost window. 


Mouie 


Import... 161 

EHport... ^2 

EHport fls Hinted Moiiie.., 865 

Figure 8. The Movie menu in Q’lVataEx. 

Selecting one of these items results in our 
application calling one of the functions we've defined 
earlier (that is, either QTDX„lmporlAnyNonMovie, 
QTDX_ExportMovieAsAnyTypeFi]e, (>r 

QTDX_ExportMovieAsHinleclMovie). Further, the function 
QTApp^SetupWindowObject installs our custom movie 
and image progress functions, so that any lengthy 
operations involving mtwies or images opened by our 
application will result in the display of our custom 
progress dialog box. For import operations, where 
there is no movie initially available, we need to specify 
the cu.stom progress function as a parameter to the 
ConvertFiieToMovieFile function (see Listing 7). 

Conclusion 

In iliis article weVe taken a preliminary^ look at tusing 
movie importei^ and exporters. WeVe used the high-level 
functioas (DonvertRleToMovieFile and ConvertMovieToFile to 
perfonn some basic importing and exporting. WeVe also 


worked directly witli movie exporters when disfclaying an 
exporter’s settings dialog Ik>x (with 
MovieEXpertDoUserDialog) and managing the settings in tirat 
dialog box (wiili MovieExportGetSettingsAsAtomContainer and 
MovieExportSetSettingsFromAtomContainer). And weVe seen 
how to display and manage llie default and c^JStom progress 
dialog boxes for Ik>Ui movies and images. 

QuickTime provides a wide array of iower-level 
importing and exporting capabtUties, If we wanted to 
export only part of a movie, for instance, we could use 
the MovieExportToFile function. Or, if we wanted to 
export a movie into memory (and not into a file), we 
could use the MovieExportToHandle function. As usual, 
we've barely just scratched the surface with movie 
importers and exporters. 
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PROGRAMMING 


Hy Patrick Taylor and Sam Krishna 


WebObjects and EOF For Everyone! 


Everyone, niis is WesORjFxrrs and EOE 
WebObjects and EOF, ims ls EvnooiVE 


When done well, programming 
provides an answer for a problem* At its 
worst, programming obscures the 
question. The first pan of that statement 
isn’t very controversial, few of us 
practice programming just for its pure 
aesthetic joy* We program for a reason 
and when we do it well, we achieve our 
purpose. 1 he difficulty that tlie sofiw^are 
industry find itself in is that normal 
practice more often resembles the worst 
case rather than the Isest. Applications 
arc fat, slow, complicated and (Kcome 
impossible to maintain. 

Jlie tool you use wont prevent 
pnsblerns, after all, you can write just as bad 
a [>rogram in Java as in Visual liastc or PERL, 
but the development environment used can 
lead ytHJ in certain directioas. WeliObjecl.s 
and Enleiprise Objects Framework (EOF) 
have inherited from cariier NeXf-era tcxils a 
certain “culturar approiicii to development 
that set them apart from practiaiUy all 
development software a^'ailable tcxLiy* Wliile 
they tmy kx>k similar to die dozens of other 
tcx)ls avalable for web ap(dicaUons 
development ;ind serving, Web(^l’)jecrts and 
FOF do things differently. And it is these cxire 
differcTic es th;if make them a gocxl choice:* 

The biggest problem facing the 
developer unfamiliar with WebObjects or 
EOF (or any of the new generation Apple 
development tools) is that “cultural” 
divide. Many classic Mac OS programmers 
have lieen using object-oricnied uk>1s of 
one scjtt or another for well over IQ years 
starting i>erhaps with Object Pascal and 
ending with C++ or Java, lK)wever there is 


a strong sense that the objecH)rienled approaches we used 
were ‘‘lx>lled on*” While our tools have lx:crt getting more 
object-oriented, the target platform (whether it is the MacOS, 
Windows or a web application .server) is still as procedural 
today as it was in the 1980s. 

In cx)ntrast, yeai>i liefoie many of us had even heard die tenn, 
NeXT made oliject-orientation an essential aspect of their ttx)Ls and 
plaifoniis. Bear in mind, that this object-oriental ion is not of the timid 
C++ variety but die older and im)re radical SiimllTalk variety of 
OOPLs (objecc-orientcxl pn^ramming languages). EOF and 
Wel)OI)}ecis bring diLs radiciiiism out of die academic closet and into 
the very practical world of ditahisc^ and die W*-b. 

The Back S iory (A New Hope) 

One of the diffictilties in exj^laining why WclTOhjects and 
EOF aie such jxiwerfu] ttxils and technologies Is that there isn't 
miK'h of a cx^mmon history. The Irac k story of NeXT is partly 
known but like the history of the Macintosh, it is so intertwined 
with the story of Steve Jobs, that it is difTicult lu give the. 
technology its due* 

Apple hasn’t Ix^en much help here. Many people in die 
industry refer lo the way Apple sells Wel>Objc'cLs and EOF as 
“stealth marketing*" Whether WeliOhjects and EOF are the bc‘st 
kept secrets of the w'eb iipi>lication market Ixec'au.se Apple 
doesn^t know how to .sell to the enterprise or tliey arc waiting 
until MacOS X arrives in its full “A(jiia”-fied glory is the subject 
for an editorial not a technical iiilrt>duclion* There is a great deal 
to admire alK>ui these prcxluds and they could umke a big 
difference to you as a developer, hut the first step in demystifying 
Is to tell the back .story. 

Unless ytm have some of that history, you'll pn^lxibly always 
wonder why the original developers did w^hat they did. Or, 
alternately, you could resort u> tlie ever-popular “it just works" 
ex(>lanuLion Since neither of these options puts any ftxKl on our 
table, this series will attempt to expLiin WelXJbjects and EOF, not 
ju*Hi in a technical w'ay, l>ui also in a historical .sense. ITiere is 
much more to know there than the fact that WebObjecis has the 
cool name and EOF ihe dorky one* 

So, if you want to understand NeXT technologies, you slic^ukl 
at least know a little bit alx)ut Objective C ... 
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The M()r>e.’ViEW-CoNTROiJj^R Software Pattern 

Mcxlcl-Vicw-Cx^ntroller (or MVC) has its r{K>ts in SniullTalk, 
according to tlic famous Design l^inerns Ixxjk by Erich Gamma, 
Richard Helm, Ralpli Johnson, and Jolin Vlissicles. MVC consists 
of a triaci of classes whicii are structured to decou[>le die 
behavitjr of die appliaition from its user interface. In MVC often 
tlie most reusable parts are the Model classes and the View 
classes while the Controller ckisses are rately reused. 

An example woukl probaldy lie the most useful here to 
illustj-ate what happens. Since Apple hasn't managed to signifit:antjy 
update the Calcubtor in the classic MacOS, you might want to 
dev*elop a halbdet'ent atkailattm In this progr4im, there would lie a 
CalculalorModel class whidi lias the Cfxle used to actually perform 
:ind return resulLs of the computation; a CakubaorContnoller class 
which i.s used to brtiker lietwccn the Gtlailator UI and the 
CalculalorModel class; and a CalcuhitorConm>ller class which Ls 
used to broker lx.'iween tlie Qdailuior IJI and the CilculaiorMtxlel 
class - il pissc's input from vanoiis digit and operations buttons and 
a text field to the CalculalorModel class to perfonn computation. 
Tire View part of the Calcuiator is actually a set of classes ased to 
represent digits 0-% the .symbols for math opeotioas (atldition, 
sulxractioiit multi pi iaition, and division)^ and a text field which 
actually c’ao rer^ive direct keyboard input as well as display 
computational results, 

Ikffjrc MVC, many programmers would simply cnim all of tliis 
into a monolithic: cxxJe mess; interlace, coinpuiational engine and 
alL 'Ibe compuuilion code for 'addition' be inside the *+' (plus) 
cxxle widget! Pertiaps this doesn't axfm iike suc h a terrible tiling, 
but by sepamting the Mcxlel and the View, we could use 
\Vel>Objeas to Ixiild a ne%v view biised on eillier H1*ML or a Java 
client applet wJiich used the exact same compulation engine. Or 
we could build an inierface designed just for Windows, Or convert 
the interface to t:om[}yte using Roman niinierals. While this miglit 
not set!m like such a big de^i^ for a calailator, it makes far more 
sense for hundreds of higjter-end application.s. 


Interface/Access/Control 

Tile HOP 2 LC'am realiied thty needed to have broad 
fimaional separation as well as leverage off of the w'ork of the 
engineering team liehind AfjpKit, die deskte^p UT framewcirk for 
Ofxmtep aka Yeliow Box akt Ccxxxi. In general, daialrase 
functionality breaks down in three plaLes: the interfac'e or display 
of the data I'clched; access, lire actual retrieval and manipulation of 
the data at the database' icvel; ;md rantml, ilic layer which brokers 
lietw^eefi interface and access. POF2 provided a datahase-spedfic 
variation on MVC, and it worked spectaciibrty welL 

Tlie Access layer is resix>nsible for acLuaUy generating the 
SQL necessary to cTeaie a “slate reflection" of the actual suite of 
the BOs (Rnterprise Object.s) in Jiiemory at the time the EOF 
et]iiivaleni of a commit is called. There are tw^o distinct layers 
tcj the Access layer: tlie EOAdaptor layer and the EODatabase 
layer. At the lowest level, the EOAdaptor layer is responsible for 
the SQL generation. The EODarabase layer is responsible for 
taking the rows fetched through the EOAdaptor layer and 
packaging them iiitu EOs and registering this witli tlie Control 
layer. What’s incredibly t:cK>i about the Aemss layer is that all 
your SQL is generated for you at mniime—you don't ever have 
to write SQL again if you're just doing generic SELECTS, 
INSERTS, UPDATES, and DELETlLs. 

Tlie Control layer Ls a^spoasible for managing die EOs in 
memoiy* and notilying both the Interfiice and Act'ess layers to 
U|idate dieir infoniiaiion whenever EOs change in menifiry or 
wfien a aimmil Ls rtxjuesied by the user. Widiout getting into too 
much detail, the Ctmirol layer is responsible for managing tlie state 
infbrm^ition of die EOs as well as conDolling the otlier layers. 

Tliere are actually two dilTerent versions of ilic Interface layer: 
lliu WelYJbjecls fratiiewoik and the EQInterface framework, 
EOinierface Is used for desktop applications and maps various 
atiributc-s of EOs to desktop widgets- while die Wel?Objetts IJI 
framework does the same, but fitim a web |>en>pective. El 


Fight Boredom 

Let’s face it: Much of programming is boring 
and repetitive. Well, that’s where the right 
tool can save days, weeks, or even months 
of your valuable time. 

AppMaker 

Your Assistant Programmer 


AppMaker makes it faster arid easier to make an 
application. It's like having your own assistant 
programmer. You point and click to tell 
AppMaker the results you want, then it 
generates “human, professional quality code” 
to implement your design. 


User 

Interface 


Apple 

Events 






Abstract Model 


Application 

Logic 


ModehView-Controller 

AppMaker’s generated code uses the MVC 
paradigm. It separates the user interface 
from application logic, making code easier 
to write. You deal only with abstract data; 
AppMaker takes care of the user interface. 

Scriptable Applications 

AppMaker generates the 'aete' resource and 
generates code to access your data 
(Properties and Elements in the Apple Event 
Object Model) and to handle Events. 


Just $199 from www.devdepot.com 
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A Brief Stoky ofr OitjE<TivE-C or yoit use C++, yoiir 

OBJECTS can’t hear YOlf SCREAM’’ 

CompiitCT languages can inspirL' remarkable loyally- Reg;mlles.s 
wliat flaws might cxLsl, liiere is mrely a language thit cloesn'l jx>ssess 
at least a smjill ailt of dediaiiecl followers- Flame wars l^etwecn 
language adv<K:ate5 are so ever-present dial it has become 
commonplace for language agnostics to argue that aU languages ane 
equally useful. 'Ihis is a nice .semimeni. but all languages have 
different strcngtlis and weaknesses- As a friend of mine used to say, 
“Pizza is nice, pirn is kisty, but you on’t eat pizza every night-" 
01>jeaive C Is such a language, hill of advantages and flaws, some 
perceived, some real. And it w^as just those piopenies of Objective 
C that made WelDOI>jec1s and HOF possible. 

Languages ;tre aealed as an answer io an immediate pRjbiem. 
tn tlie CISC* of Objective C, tlic problem was one dcs<'ribed back in 
1968 :is the “scjftwate crisis-" Fred BnK>k.s wrote alx)ut tliLs problem 
in las seminal work “Tlie Mythical Man-Month” and in liis famous 
article “Nr) Silver Bullet: Es.sence and Accidents of Software 
Engineering” In a niitsheil, tlie ,s<^tware cTisLs is caused iiy tlie 
difflnilty to scale software development- An iimifficient numlx^r of 
people are available to develop the increasingly n>ore complex 
applicuions lire market demands. The piiradox is tliat adding moie 
workers to a project Ls not a solution; in fact, this would most likely 
aggravate the situation due to diftjculties in managing the increased 
coniniunicalion complexity and the new w^orkers' viiiying leveb of 
tet’hnical ability. According to Bttxjks, the pnol^leni is not one tliat 
will ever inipiove dramatirally Im^ause the very namie of software 
development will imjxxle tills cliange, Attd despite ihe huge libraries 
of how'-tos and programming inethtxlolpgy lx)oks, Bnioks’ thesis 
-SCC 1 US to be holding tme. 

Brad Cox didn't Ix-licve this had to be so. In his Byte aniclc 
“What if tltere is a Stiver Bullet: And tlie Coiiqxnition Gets fhere 
First?”, Cox argued tfiat rhe problem isn’t staictural to computer 
programming it.self, l)ut had more to do with the way the 
industiy' carried out development. Taking an anisan-like 
approach to [>rogramming, developers were creating unique 
iiii[)lemenrations of softw'are each and every time. Brad Cox 
profiosed tlie idea that software develofimeni needed to go 
through its owm “Industrial Revolution," 

Wliile code-reuse gels a l(.>t of lip servic e today, it is .still rare 
that signilicani amounts of cmle gel reuscxl. And—this is tlie 
critic'al point—even when we do prac tice reuse, we do it as an 
add-on. To overcome the software crisis, \hv whole process of 
ccxling must c hange to make it .simpler to jiraccice reuse. “Re¬ 
user-friendly." if you will. 

Many people complain alxiut a pioblem, Brad Cox did 
somc*tliing about it, I k oeatexi Objective C, a t:omputer kinguage 
tiiiJt added a sniall set of nl7jett-{)riented exteusioas to die ever- 
jxipular C language. Among its other fcalums, Objective C featun^l 
a dynamic niniime that allowed tximpiled olijetis to communicate 
wath otlier oljjcxts witliout kne^wing rhe exact implementation of the 
laiget object. Tlie icrason for tlie dynamic runtime was that Cox 
foresaw' a day when programming involved groups of 
interchangeable “.softw^are widgets" 


Cox dkln't create Olijective C from .scraidi, he fxirrowed the 
syntax ^ind pliilosophy fnnm SmallTalk, the gjand-daddy of objeci- 
oricntcfcl programming languages. SinallTalk was an inierfiicicxl 
language environment wliose renruirkible flexibility was used to 
create the first graphical interfaces emerging from Xerox PARC. 
Some of' tile finest minds in computing are associated willi 
SmallTalk, inchiding Alan Kay, a Macintosh legend in his own right, 
and Kent Beck, author of several das.sic books on piogramining- 

While far more advanced dian any oclier piogmmming 
language of its day, SimillT;iJk's problem (oilier than its shetT 
alieness whvn cximpared to tlie pnx:edunil languages of the day) 
was that, being interpreted and message-passing, then.' were 
significant perfomiiince problems- 'Ilie tratkx)lf of peiibnmnce for 
flexibility and development speed w^ere niincjr ones for the 
academics and researchers who used Small'lalk to create the early 
prototypes of our present day interfaces and applicatioas. 
Commerckiny SnxiUTalk was much hander to sell, not that the 
haidcote fans ditln't try. 

Brad Cox however rook a middle road and hybridized 
SmallTalk (easy to program and reuse) mih C (fast and 
compiled) to create Objective C- Almost two decades later, it is 
easy to forget that Cox was wa^rking in a world where 
micixKXimputers had 8- or 16-bit proces.sors that topj>ed out ai 
about 8 MHz. Many prograjnmers still swore by as.senibler due 
to the scarcity of resources, nt)l the lea.st of which wa.s less 
memory than you1l find included .standard on an L-2 cache on 
a modern proceSxSor.So wdiile far from perfeciH Objective C was 
proixibty the Ik^-sI compromise between his goals and the reality 
of the computer industry at the time. 

-Steve Jolis exits, stage left. Then returns trhimpliaiidy 

Few figures have dominatetl the computer industry' like 
Steve Jobs, and none have done so in c|iiiie the same way- 
After his much-publicized break from Apple, Steve Jobs was 
looking for another opportunity to change the w'orid. This 
time, however, he would do it right. 

Wliai he ended u[i doing was coUeaing a rag-tag group of 
geniu-ses to build a bond-new' OfX-Taiing system. Tlieie wus little 
alxiui NeXT's new' firoduci that wasn't leading alge. Often the trade 
pres,s have fcx'used on the Unix internals, liow'ever, what 
distingoLshed NeXTs OS from tlie competitkJii was the objett- 
orienttxl frameworks fitjsted above the BSD/Mach kernel. In-S[>ircd 
by die same Xerox PARC visit that luc4ed Joixs' exc itement for 
graphical interfaces, object-orienuiuon Ixx’ame the cxire comperency 
of NeXJ'. Steve Jotis I)et:ame the object s most cJiarisiiiiilic advexate, 

“When I went to Xerox PARC in 1979, I sjiw' a vey 
rudimentary graphical user interface. It wasn't cumtilcie. ft w'asn't 
cjuite right- Bui within 10 minutes, it was olwious tliat eveiyf 
computei' in the world would work this way someday .... Once 
you undcrstancl objects, it's clc-ar that all .softw'are will eventually 
be written using objeas..-. It’s so compelling. ICs ,so obvious. It's 
so much better that iPs just going to happen." 

Quoted From “Steve JoliS! The Next Insanely Gre^it lliing" 
Wired 4-02 Feb. 1996 
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Programming Doesn't Have 
To Be This Difficult. It's REALbasic! 




REALbasic IS the award-winning, visual, 
object-oriented BASIC development 
environment for the Macintosh, 

Use REALbasic's visual interface builder 
and platform-independent language to build 
native, compiled (not interpreled). profes¬ 
sional quality applications in a fraction of the 
time it would take in C/C-h-* Because our language 
is platform-independent you only need to write a single set of 
code to create appUcations for both Macintosh and Windows. 
Leverage your C/C++ experience to extend REALbasic's capa¬ 
bilities using shared libraries, Mac OS Toolbox and Winja 
API calls or by writing cross-platform REALbasic plug-ins. 

Create prototypes, Internet applications, front-ends to 
databases, even games with REALbasic! Its OOP language 


employs everything you'd expect from a modem development 
environment—methods, properties, classes, subclassing, 
inheritance, constructors and destructors, virtual methods, 
and more. The IDE supports multi-threading, extensibility. 
TCP/IP controls, plus multimedia and QuickTime tools, 
and support for standards such as SQL, ODBC. AppleScript, 
and XCMDs. You can even import Visual Basic forms 
and modules. 

Go to www.realba5ic.com NOW to download a 
FREE trial version or call 512.263.1Z33. 

3 REALbasic 

REALbasic (s a registered trademark of REAL Software, Inc, 
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"Free update lor ell uf 

REALbasto 2.0 and above 
All olher |T^de^^arks property Ot 
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Wl’ien NeXTs software engineers were 
searching for a language with which to write 
their object-urienfecl framewtirLs, they tlitln t 
have the wealth of cjpTlons availal^le today. 
OOP was far from a inainstream choice in the 
niid-ms even if Byte magazine and other 
"vt^ic^es in the wilderness'* kept announcing that 
this "‘fmure” was just around the corner. 
However, while everyone else w^as wailing, 
NeX'fs engineers were creating jusi siuii a 
workstaii(>n-class computer. A major 
considerating was performance, but .since they 
wvie creating a brand-new plutfonn they also 
wanted to dramatically ease developmem. 
Almost twenty years after tlic softw^are crisis liad 
first 1mm articulated, little had (K:c:tuTe<l to 
improve the development situation. In fact, 
fatware, or sloppy tlesign which resulted in 
inefficient application programming, was 
in<TeasiagIy iDecoming a problem especially 
w'itli the introduction of graphiol interfaces and 
in the later *80s the features-race. NeXT 
attempted to use OOP as a practical way to fight 
the software crisis and reduce fatware, 

Ol^jeciiveTTs qualities lx ah stmplillctl the 
creation of and pre<lefined many of NFXfslTP s 
features, llie dynamic nature of its iiintime along 
witli its support of wc*uk-typing allowed the OS to 
evolve dramatiailly without loiiviog to mwrite the 
enlim ccxlei:»ase fn^m stnitch. Tlte clh^ns that 
NeXT engineers w^eiv making on behalf of third- 
party' developers paid off for NeXT itself. 

Unlike MU‘n>w>ft Poundation Classt^ or 
Mem>werk.s Pow^erfilant NeX'J^'s frameworks 
weren’t absinictions of pn)c:edimil Al^Is. 'lire 
(levelopjiieni frann.‘wx)rks weie tlie tatger APIs, in 
faa. in a very^ re;il ,sease. the NeXl* frameworks 
were the only part of the OS that truly matter 
(which NeXT engineers proved when [hey \xm<x\ 
Uie fnimeworks from Maciv'BSf) UnLx to Solaris, 
I and Window's NT). 

Written in Ol.ijective C, tliese fnimcworks 
were collections t>f tcxnmon interface elements 
and data ty^pes w'hidi could lx* easily ackk-d to 
your applic^ition. While not quite a colleaion of 
“software w'idgeLs** as Cox envisagcxl, Appklr and 
Fountlaiion gave dcvelt)pefs a head-start in 
cncating new appliaitions by eliminating most of 
the gnini work. By t)reaking up the applic:iiion 
into iVl{xiei-View-C^)ntrolltT .st^gments, the NeXT 
appixjach (inspired by SmallTalk) allowed 
tlevelopers to split the interface fnmi the logic 
undern<;‘:ith. lliLs increased the Reusability' [xHenlial 
of cjbjects sina^ they werem't tied to p^uticular 
interlace elcmenis. 'Hie principle wa.s tliat you, the 


The advantages of dynamism vs. static prograniniing or “Why garbage 
collection is only import a at on gari>age day*’ 

Dymaniic typing in Objective-C freed Uie EOF deveiopei's fR)rn worrying 
whether a particular object was going lo wwk in a particnilar tmnsaction. Due 
to dynamic tyf>ing, objects in Objeclive-C are purely orthogonal structures thiit 
do not need to lx? concerned with how tliey fit (or don't fiU. You simply 
message iliem, not caring ahead of time whether that object can receive tiuil 
mes.sage or noL The disadvantage to this approach is that sometimes you can 
me^ssage an object that ti(x?s not (or can nt>i) respond to the mes,sage, and tile 
mntime will thrown an exception bringing the app a halt. 

In static typing (or strong typing), the prograninicT defines ahead of 
lime if something can respond to a mes.sage or not at compile time. In Java, 
you always have to dowmeast an object that is renirned from a collection 
class which makes things le.ss flexible. Since ihe.se objects are mn 
orthogonal, you have to be coticenied w'ith how^ they fit (and how' to 
message them). While useful for type-checking and message-checking 
purposes, it makes things much harder to manipulate and write truly 
reusable code—'particularly if ycm*re working with c:t)de that didn't 
originate with you. 

Flexibility In typing hasn't l>een considered to be as significant a 
feaaire in a programming language as it should 1 k\ Many people rave 
alKJUt lava being one of the first mainstream languages tt> liave garbage 
collection, which auttmiatcs the process of nicmory management reducing 
the incidence of memory leaks and prematurely deaUcKiited objects. This 
can save the programmer, especially tlie newcomer a considenible amount 
of time. Unlike the benefits behind weak typing^ garbage collection is of 
liencfil only for each paiticular development project. Weak typing is far 
more usahie because objects are allowed to be purely orthogonal 
.structures and can lie re-used iti unexpected wiiys. 

One of the key elemenLs of reusability (in the NeXT/SmallTalk model) 
Ls that you stiouldn t have to be concerned ahead t>r time about the usage 
of a paniciilar cias.s or object With dynamic typing, you can store things 
in an NSArray (a particular collection class), wiilK)ut being concerned if it 
will actually go in or come out in the same form. In a statically typed 
context, you can still .store tilings in the et|iuvalent of an NSArray, but you 
will have to re-cast it back into its oiginal form on the way back uviL Also, 
you Citn forget aliout easily storing objects of different class types into an 
NSArray, It can still he done, but in order to nicssage the object 
individually, you wall have to remember its cla.ss type aiiead of time. 

As you am see, static typing encourages just the “aiTisan’* apjiroacli 
that Brad Cox wanted to avtild w^hen he created Objective C. T!ie 
developer must omnisciently manage all the interactions between different 
parts of the program. As the applicatitin increases in complexity, the 
numlier of potential interactions explodes t:)eyond what is reasonable for a 
single person a> manage. Hie addition of more people complicates the 
siUiaLicm because they must communicate the ptHential interactitms U) each 
other, increasing problems by misinformation. 

By not rccjuiring strong ty|iing. Objective C allows w^holesale 
rejilacement of objects so long as they are able to adequately respond to 
nie.ssage.s sent to them. Since the oLijects only need Lo know what messages 
they can respond to rather than knowing the properties of all the objects 
they communicate to, NeXT applications can scale letter. This makes 
Objective C a bit '‘chatty*’ as OOP goes, hut as you become more familiar 
with the NeXT Way of i'hings, you'll ,see that this is definitely a feature 
rather than a disadvantage, K1 
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pmfjranunei; shcxikl only luvc to develop Llie parts of an upplicaiion 
liiai in;ike it unique, while as miidi of llie reiiiiiining parts siiould 
be pre4abl')e<l nr easily adapted to new uses. 

NeXT IurI figured out liow^ to crextte free/r-dried interfaces that 
gcrteratL'd no code, iiierally, the obiects dial represent.s windows, 
buttons. an<l otlicr views are pul into suspended-animation, and 
tlien resiniimited w'henever a new' iristance of ilie appliaition mas 
as a coasequente of ihe dyiiiiniic ainrinie nie,vsaging. No new' cxxle 
generated means no new^ cTxle to delxig, dnistically rcdLieing the 
ammtnt of Lime needed to bring an afiplication to rrutrket. 

ITiere w^ere very mal and piactical coase<:|uences to their design 
decisions for the dcvefojXT. Anda^vv SLone, CHO of Stone Design, 
nesdetl in AlixjqueaiLie, New' Mexico, lias quietly dcvelofxxj a stalile 
of pr<KiuLis that would lx* ini[)ressivc in a com[Xtny ten linurs iLs 
size. “i.>:)ing things in a complex way Ls tlie WTong way to tki 
tilings,” Siiid Slone. ‘"ITlie NeXT appmadi allows the developer to) 
learn a suliset of things railicr ilian Learning all t)f it,” 

As you tan imagine NeXl's franit^works liiid several advantigc^ 
over its cfimpeliltirs. And for several years, llie biggc'sl advanmge 
w'as iliat NeXTs fnimeworks existed commerciaily while giants like 
115M, Ajiple and Micncxsol’t samibkxl. And stunibled batlly. 

Bhinguvg t™ NeXT Reugion to Daiaeases 
As tlie VMki gave way to the 199ds, NeXTs focus shifted to the 
enterprise*. NeXTs frameworks wotc well suited to oeating the 
client-sencT applications tlial were fxtoming so popular in 
G}r|X)rate America, When one talks afiouL dient-seiver, they are 
generally talking alK>ut working with dauilxises and in the enterj:)iise 
talking alxiut ckitabsises nx*uas SQL, Ibe Siandardi/cd Qut*ry 
language tliQL) was intended to provide developt^rs wiiii a 
coninxin w'ay to interact with data assets, and yet even icxlay, few 
aHationa! (ktuilxise systems (KDBMS) supjxirt SQL in its enti^et>^ 


How' hard is it to write a database application the 
traditional w^ay? 

Well, the an.swer is: it depends. At some point, a few 
things have to be dealt wrillit SQL to fetch the data, SQL to 
update the data, SQL to insert the data, and SQL to detele the 
data (at the base level). And when a web application seiver 
is tossed into the mix, there s also the issue of importing the 
data from the SQL database to the web application to lx; 
manipulated programmatiailly and then back when it’s time 
to commit the state of the program back into die database, 
■fhis doesn't even include issues like stored procedures. 

Other application sewers often have innovative ways of 
letting you write rlie SQL yourself (w'hether it’s in the w^eb 
pages t>r in the code, or in some SQL tcinplaie file). Often 
SQL coding ts not much better than statically bound 
programming—the burden is on the developer on how to 
make the SQL work with die objeas, or tlie objects work with 
the SQL, or in some mind-bendingly awful situations, Ijoth. 
Some application servers insulate you from things like SQL by 
lying die developer to one particular brand of database. 

In most circumsnmces, EOF saves you from that by 
generating the SQL dynamically for any databa.se tJiat has an 
adaptor written for it. You didn’t hear wxong, EOF generates 
SQL dynamically. No templates, no pseudo-SQL. no iimbilicai 
cord to a single database, EOF will build the required SQL 
commands la carryout what youVe modelled and enabled 
programmatically. You don’t ever have to write SQL again if 
you don't care to—uniess you have some really high- 
performance requirement or incTedibly complex query that 
EQF can’t do. if you Ye a masochist or just love SQL, you can 
write stored procedures or embed yr>iir SQL in the code, ^md 
have EOF execute it directly. K1 
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Even dlls .stancbiniizaliun Is not much help since SQL progmniinin^ 
tends to be a hairy exercise even for experienced developers. 

EOF is what makes WebObjects exciting, 
Wel>Obiecrs is what makes EOF praclicaL 

The roots of EOF extend almost 10 years back to 
an early object-oriented datul>ase framework called 
DBKil. This proto-EOF w^as NeXT*s first attempt at 
mapping object-orientation concepts to RDBMS, This 
wa,s not an academic exercise but an attempt to answer 
a non-trivial problem: How^ can we successfully apply 
the advantages of objeci-oriented jjrogramming it> 
relational databases? NeXT had already shown that 
OOP could be a silver bullet for application 
development, but the answer to the OO-RDBMS 
problem was not immediately obvious. 

DRKit was not a resounding success, it suffered 
several flaw^s which kept it from being a practical 
addition to the NeXT frameworks. It wasn't layered 
sufficiently, though it did begin the process of adding 
adaptors to databases. And unfortunately, it sufrered 
the kiss of death from a lack of reference counting and 
countless memory leaks. However, DBKil was a 
pioneering attempt and it was im porta or step to wards 
the eventual solution. Wounded bui not defeated, 
NeX'F’s software engineers returned to tlic problem 
once again and EOF l,x w^as born. Certain key features 
like EOEditingConiexi were missing, .so even EOF 1.x 
didn't provide all the answers. 

EOF 2 saw the light in 1996, after WebObjects 1.0 
shi[)ped which was architected to take advantage of 
features from EOF 1.x. EOF2 was an apex in NeXT's 
framework history. .Signitkanlly, it laid the foundation for 
all versions of WebObjects since. After EOF2, the 
framewx>rk has l^een rel'inird rather than rearchitected 
even in the age of Rhapsody and MacOS X. However, it 
had to <lie tw'ice (in ixjth DBKil ancl EOF l,x forms) 
lx?fore it croiild come back to solve die fundanienUil 
problem of mapping OO-RDBMS development properly. 

As it happened though, EOF 2 did not set the world 
on fire. Coming of age just as the World Wide Web was 
beginning to take off, the frameworks seemed to lie 
answers tt) old que.slinns. The client/serv^er market began 
thinking outside the LAN tt) WANs and extranets, things 
that were exotic: when EOF was being crealecL Its key 
market just wasn't as interested anymore. 

The crucial step in going from apparent failure lo 
promising success was in realizing how broad the 
question was that the EOF Team was answering, llie true 
potential of both EOF and WebObjecLs was redeemed 
when the team members realized how ptiwerful the two 
technologies could be working together. Rather than 
reinvendng fragmeiiLs of the funccicmality in EOF lo solve 
what the engineers had thought were WeliObjecLs' 
problems, they revolutionized the Web through a synergy 
of these two formerly independent technologies. 


The rest of the articles in the series will specifieally 
look at key elements of WebObjects and EOF. Layer, by 
layer, each article will reveal new and sometimes 
revcdulionary feaiures of this remarkable technology. 
In order of appearance, here are brief summaries of 
what we will cover. 

The Request-Response Cycle 

WebObjects provides an object-oriented abstraction 
of what occurs during an HTTl^ recjue.sFresponse cycle. 
Normally, a browser makes a request for a page from 
the server, the server responds by serving the requested 
page, if available, to the correct browser. WebObjects 
provides the developer with several vector hooks lo 
intercept, augment or even completely override this 
standard behaviour from williin the programming 
environment. By carrying this out from within 
WebObjecLs, tlie developer take advantage of a real 
application system behind a web serv^er. 

State Management 

By virtue of its statelessness, HITF make.s the job 
of managing client-server interactions a major cffori in 
any wei> appiicatitm. WeliObjecis manages state at 
three independent levels: global, user and local; 
represented by three scope states: WO Application 
(global), WOSessiun (user) and WOComponent (local). 
'I'hese allow the develojier to vary stale without having 
to write vast quantities of eustoin cocle or script uniciue 
behaviours. .Stale management happens in the 
application code base allowing the developer to create 
unique l>ehaviours for different apps. In fad, after 
using WebObjects fur any amount of rime, you'll begin 
to fall under the illusion that HTTP is slate-oriented 
after all. Why everyone doesn't manage state like this 
may be the biggest my.stery of all, 

EOModeling 

EO Mode I Hug is cornerstone of EOF, the way in 
which Entity-Relationship modeling gets done. Objects 
are modeled as EOEniities which have corresponding 
RDBMS tables. Ct>lumns in tables have corresponding 
EO Attributes which are the atomic units that comprise 
EOEniities. A relationship berween two tables is 
represented by an EORelutionship. And all of this is 
neatly packaged togeitier in an COModel. Again, once 
you understand EOModeling, you 11 wt>nder why 
there's any other conceptual ctmipetitors. 

EOKeyValueCoding 

EOKeyValueCoding is the universal protocol (or in 
the case of Java, interface) that allows EOF to have 
access to all ivars/attributes/accessors/methods in a 
standard, uniform way. Denoted primarily by two 
methods, takeValue:ffjrKey (Java: takeValueForKeyO ) 
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and valueForKey: (Java — valucForKeyO 
EOKeyValueCoding i>erforms the runtime mapping of 
an individual table row to a corresponding enterprise 
object (EG) in the POE runtime layer. This is key tt) the 
RDBMS to object iiiai>ping process that EOF uses. 
EOKeyValticCoding also allows the universal 
manipulation of these EOs without actually liaving to 
guess at what the aeeessors will be. EOKeyValueCoding 
allows all objects (not just PGs) lo represent themselves 
as dictionary objects^ whicli in turn further blur the 
strung typing/weak typing distinction. 

EOFAtJLliJVG 

The EOFaulting mechanism frees the EOF 
developer from the worry of explicitly fetching (or 
implicilly fetching) the entire relationship-driven object 
graph of a given HO, For example, if you fetched a 
Salesperson HO, you wouldn't have to worry abenU 
also fetching the Salesperson's Department, Manager, 
and Customer PCs as well (at least at fetch time). And 
you wanted to know' about those otlter relationships, 
all you have to do is ask the Salesperson about its 
particular relationship, and EOFaulting performs a just” 
in-time fetch of the EOs for a given relationship. 

EOKihtingContext 

The HOKditingContext is the cai>stone of the 
Enterprise Ol>jects Framework. It also is arguably the 
most t^owerful class ever wnllen in the history t>f object- 
oriented program[Tiing. Once it was developed it 
became central to tlie reart :h itecting of EOF fnmi 
version 1.x to 2,x. 'I'he EOEdiiingContext manages row 
insertion, row' deletion, row updating, and row fetching. 
It also tiTicks the changes in bt)Lh an undo/recio st:ope 
for all EOs registered with the EOEdiiingContext. 
Ultimately, it manages the transaction scope for a 
particular series of events alt the way through its 
existent:c. It knows all and can do all. 
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Webmasters and solution providers 

Ho matter what your experience, 
Scripter makes it easier! 

BEGINNER AT SCRIPTING? 

• Unique command'builders help you learn to 
assemble commands 

• Built-in tools for experimenting 

• Shortcuts to speed scripting 

EXPERIENCED WITH APPLESCRIPT? 

• Unmatched single-step interactive debugging 

• Watch and modify global and local variables 
while stepping 

• Debug messages sent to script applications 

• Includes SaiptBase to integrate scripting scenarios 


In Conci.usion 

Any cullunil change involves a significant amount 
of effort. And it would be wrong u> minimize tlie 
learning curve that WehObjecLs and EOJ' involve, thi.s 
is not a “Learn WebObjeets during your Lunch Break" 
article series. While, the new developer pays a bigger 
price at the start but each breakthrough made will pay 
off throughout the re.st of tlie learning process. 
WebObjeets and KOF are remarkable consistent so you 
will find remarkably few areas where the rules you 
internalize dtm’t apply where you expect them. 

NeXT and now Apple seem to follow a pattern of 
creating frameworks that are simple, but not simplistic, 
complex but not complicated. When you understand 
the philosophy, there is an opportunity to bring this 
elegance to your own software. Ki 
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PROGRAMMER'S 

BOOKSHELF 


By Paul E. Setnn^, Switzerland 


REALbasic:The Definitive Guide 


INTRODLTCTION 

REA f.basic is iin Integra ced development 
environment (IDE) from REAL Software^ Inc. [31. In the 
last couple of months, REALbasic was the topic of several 
MacTech articles written by Erick Tejkowski [4, 5^ 6, 71 
For an overview of REALfnisie, please refer to Brick’s 
second article [51 or the REALbasic liome page [31. 

Written by Mall Neuburg and published by 
O'Reilly, REALbasic: The Definitive Guide [2] describes 
the higher edition of REALbasic version 2. But as 
targeting Windows is not covered, most of the text 
applies to the standard edition as well. Man Neuburg is 
a past editor of MacTech, by the way, but tit is shall 
have no influence on my review. 

The book is divided into three parts of about 210 
pages each: Fundamentais, User interface, and 
Reaching Out. Please note that unlike the first two 
parts, 1 haven't read the last pan in its entirety (i.e., in 
number of pages, I have reatl about a third). Note 
funher that I have never dealt with REALbasic prior to 
reading this book. 

Fundami-ntals 

Chapter 1, The Workspace, and cliapter 2, ike Basic 
Language, inrrtKliice the REAiJ>asic IDE and the 
REALbasic language, respectively. Tfie explanations of 
tlie language consirycLs might be too terse for novices at 
programming. For every!Kidy else, however, ihe concise 
writing allow.s for a quick transition to REALba.sic 
without being boring or superficiaL What irritated me a 
little at ihe beginning is that some namc.s are capitalized 
differently in the code examples and in the main text. 
(REALbasic is case insensitive.) And Neiiburg's definition 
of “side effect" is somewhat sloppy. Nevertheless, after 
two chapters only, I gained the impression tliat he is a 
pretty good teacher and writer. 


Chapter 3, Objects, Classes, and Instances, and 
chapter 4, Suhciasses, introduce object orientation in 
the ctmlext of REALbasic. These tw'o cliapters risk to 
frustrate novices at object-oriented programming 
(0(3P): while a lot of concepts are explained in a very 
intuitive manner, non-trivial examples in which OOP 
unleashes its power are lacking. Beginners must be 
aware of this. After all, h is only natural that there are 
trade-offs when a book treats a language, a paradigm, 
an IDE, and a framework. Alas, Neuburg's trcaiment of 
interfaces may leave a wrong impression, namely that 
they are primarily a means of fixing class relationships 
or of supporting so-called binding. Yet every 
experienced Java prugrammer will confirm that single 
implementation inheritance with multiple interface 
inlierilance allows for very clean and powerful designs. 

Chapter 5, Datatypes, discusses elementary 
REALbasic data types, such as booleans, strings, and 
dales, as w^ell as two classes that support low-level 
memory handling and threading, respectively. In the 
section on numbers, Neuburg uses the terms “binary'', 
“octar, and “hexadecimal” without explaining them 
anywhere in the book. This (and what I .said about 
novices in llie preceding two paragraphs) leads me to 
the following question: Who is the target readership of 
the book in the first place? (On the cover it says 
"Macintosh programmers at ali levels” anil in the 
preface Ibis hook does not teach ytm to program the 
Macintosh if it includes beginners, some sections of 
the book need to be elaborated. If not, some sections 
are not necessary (e.g., on what flow control is). 

Chapter 6, Menus, shows how menus and menu 
items are created, how tliey can he ena[:)ied and disal)led, 
how the application reacts to a menu item being chosen, 
etc. I particularly liked that it includes a .section on 
dynamic menus with typical examples (Font menu and 


Paul ret enily earned a Dipl. El.-lng. hTH degree, the MasicCs degree in electricil engineering fmrn lire SwL'is Federal In.stirLite of Technology Zurich 
(irrHZ). Now he hopes to fmaily fmd the time to finish Aho et al.'s Dnigon Rook. You can inquire^ on his progress at paulscvinc^ubiiab.org. 
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Windows nicnii). And chapter 7» The Architecture of an 
Af}})lication, gives some tips concerning REAlJ^astc-based 
applkuLions. It does not disaiss archileaural issues in 
general, however (See, for instance, Biischmann ei r/7 [1] 
for more on this topic.) 

Cliapler 8, Debuj^gin^ii and HuHding, concludes the 
first part. U explains how lo read compile-error 
descriptions, REALl>asic’s exception liandling, how to use 
the debugger, and the application build. After the first 
three images in the section on exceptions, I was going to 
say that Neul:>urg cliose a poor first example to illustrate 
them. Because it calches an exception caused by an error 
that can be fixed during development and that does not 
depend on the time ik space in which the final applicution 
runs (e,g., on a eonipuier with an unrelialde hard drive). 
However, 1 ihen saw that four of RKALha.s^c^s five (or six) 
RuntimeExcepf.ion subclasses are about such errors, so 
that Neuhurg isn't the <me to be blamed. Nevertheless, he 
should have said more than just ‘\Most of the lime, you'll 
prohah/y to eiiminate runtime errors from your 
program iu acipctuce"'[f p. 2061. 

User In iehfacf. 

'Ihe first ten chapters of the second p;u1 cover 
graphical user interface (GUI) elements, the remaining mo 
discuss the keyboard and the mouse. As is staled in the 
preface, the Hunian Interface Guidelines are not a topic of 
the hook. Many tlilferenl GiLft elements are explained, such 
as windows, tab panels, sliders, etc. In addiiion to rlie 
default classes that RHALbasic provides, Neuburg also 
jirestmrs subclasses and helper cla.sses developed by him 
and Olliers, lurthermore, a few' advanced examples are 
also included. What I liked a loi is that Neuburg warns 
against hugs or limitaiions he encountered and tells the 
reader what to dti alxjut them. 

To cut a long siivry short, this part is likely to coniarn 
valual)le infixluaiion about the GUI element the reader 
would like to employ. And in ca.se the GUI element Ls not 
available or does nor liehave as desired, several w^ays to 
create a cusumi GUI element are shown as well. 

REj\auNG Otrr 

("hapter 21, Files, covers many file-relaied issues: 
creating and deleting files, navigating tlie file system, 
reading and wriiing the data or n^source fork, preferences 
and temporary files, etc. i'he concept of file tyfX’ and file 
creator is brielly explained, the dilTerence 1x1 ween data fork 
and resource fork not really. Ovenill, however, the level of 
detail and the examples are very good. Particularly cool is 
tliai some of the example msks — copying, for instance — 
are not only solved with REAI.ba,sic classes, l>ut also with 
AppleScript scripts imported into the REAUiasic projeti. 

Chapter 29, Printing, is rather short, which— 
considering its importance—is a pity. Apparently rhat's 
because \^upporr for pn>//f>7^ in REALhasic is 


nidimeriiaTy^'ll, p. So, after a few tips, the reader is 
left to her own experimentation. 

Chapter 31, Apple Events and AppleScript, first briefly 
introduces Apple events and AppleScript and then 
tli.scusses Apple events and the RF.AI.basic classes that 
support them in quite some detail. This chapter teaches 
liow' to send and receive events in order to make an 
application scriptable, and iiuw to execute scripts from 
within an applicalitm. 

To give you an idea of what other topics the third part 
includes, here are the titles of the remaining chapters (that 
1 haven't read): Databases, Ciipboard, t)rag-and~Drop, 
Time, Sound, Movies, Game Animaliou TCF/fP 
Commuuications, and Langimge Extensions. 

CONCI.IISION 

Despite .some shortcoming.s, Matt Neuburg's excellent 
writing and its broad range of to[>ics make RE^ilhasic: The 
Dtfiuiiwe Guide an ea.sy-ro-Linderstand and very useful 
hook for programmers entering the world of REAl.basic. 

In my opinion, the book is !>esl suited for 
programmers with experience in OOP. Other 
]irogrammers should do just fine, too, even though their 
perception of object oriental ion w-ill probably be 
somewhat limited. For a complete novice, however, this 
book alone is not enough (o get started. 

What is clearly missing is an example ajiplication 
(e.g., a simple text editor) where diffeiem aspects such as 
menus, windows, files, printing, etc. could have been 
shown side by side. So leej tree lo develop such an 
application and to write about it in Mac'l'ech! 
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By Jeff elites <online@niaclech.com> 


XML:The Promise and the Hype 


A few months ago, wc l)riefly touched on the 
subject of XML, the biggest hype magnet .since Java- A 
quick glance at any IT-re I a ted publication or weirs ite 
will give you a pretty good idea of the degree of 
interest there is in anything related to XML, and 
companies are churning out press releases about their 
plans to utilize XML faster than the press can cover 
lliem. XML isn't the Next big Thing, it's the Current Big 
Thing. No matter where ytnt stand on the hype-versus- 
suhstance issue, as a developer you1l need a working 
understanding of the technology to meet the demands 
of new standards and new modes of application 
interoperafniily. Beneath the static there is great 
potential in XML, and everyone will benefit from the 
attenlitm it is drawing to issues surrounding 
communication and slandardization. This montli we'll 
cover a few of the resources you can turn to when 
working with this rapidly growing Lechnoiogy. 

EkK:UMENTATION 

Although there are many choices available, it is 
difficult to find tfie perfect printed reference; many of 
the obvious choices turn out nor to be very good, anti 
the field is evolving so rapidly that even the high- 
quality books tjutckly become out-ohdale, Pcir the 
moment, though, there are a couple of winners. The 
sXML Pocket Rt^erence, from O'Reilly and Associates, 
serves as hotli a beginner's introduction and a quick 
reference. Tor an extensive survey of current (and 
developing) technologies and APIs, try Frofesstonai 
XML from Wrox Press. 

XML Pocket Reference 
<http://www.orei llyxom/catalog/xmlpr/> 

Professional XML 

<http://www.wrox,com/Consumer/Store/ 

Details.asp?ISBN=1S61003110> 


There is also no end to web-based coverage. An 
indispensal^le source is the XML FAQ, which t‘overs a 
wide range of U>pics, and is well written. At the other 
end of the clifficulty specirutn is the XML specification 
itself. Although youTl want to avoid it as long as 
possible, at some point you'll need to go back to the 
.source to get the definitive word on something. It's a 
difficult read, l-^ut there is a cleverly-constructed 
annotated vers it m available, which makes deciphering 
the formal language a bit ea.sier. This latter reference is 
provided by XML.com, which is an excellent source of 
reference.s and ongoing coverage of the industry, with 
timely articles t>n emerging technologies. Next, the XMl, 
Cover Pages are an exhaustive and neutral reference 
for all things XML (and SGML) related. Also of general 
interest is the original ‘‘mission statement” of the XMl. 
suindard, which sets forth the design goals for its 
development. Finally, those jilanning on developing or 
working with XML parsers should take a look al the 
Lark parser, developed by Tim Bray, co-editor of the 
XMl. specification. It does not appear to be under 
active development, but it does provide an interesting 
case study in parser development in Java. 

The XML FAQ 

< http://www. ucc Je/xmt/> 

The Annotated XML Specification 
<http://www.xmlcom/pub/axnnl/axmlintro.html> 

XML.com 

< http://www.xml, com/pub> 

The XML Cover Pages 

<http://www.oasis-open.org/cover/xmLhtml> 

Design Principles for XML 

<http://www, textuality.com/sgml-erb/ddd 996-000 l.htmb 
An Introduction to XML Processing with Lark and Lan/al 
<http://vww.textuality.coTn/Lark/> 
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Pkogrammin(; xml 

XML wa.s designed to be easy to parse, and XML 
documents are often charaeteiized as self-describing, 
[)ut if you need to develop an XML-prot:cssing 
application you 11 quickly find oui that this is 
nonetheless not a trivial job. fortunately, there are a 
number of parsers out there to help you with this task, 
and simple XML documents can in fact be created and 
parsed simply. One of the first XML parsers, and 
perhaps the most widely used, is James Clark's expat. 
It\s a non-validating parser writien in C, and recently 
an Obfcctive C wrapper has been created for it, so it 
should be straightforward to use it from within Cocoa 
applications. (I believe that expat is also being used 
internally within Mac OS X, Imt it isnl clear what sort 
of API Apple will pnrvide to access it.) Mrwing 
forward, it is likely that the Xerces parsers, which are 
part of the Apache XMI. project, will be widely used, 
‘fhey are validating parsers, and are available in Java, 
C++, and Perl. Much of their code oiiginated from 
IBM's alpliaWorks project, and IBM ctrntinues to 
provide its own versions, XML4J and XML4C for the 
Java and C++ versions respectively, which combine 
Xerces with their own Unicode classes, providing 
support for an expanded range of encodings, Apple is 
in fact using XML4J in their recently-re leased version 
4,1 of WehObjects, and again it isn’t clear to what 
extent the parser will be accessible from other parts of 
Apple's frameworks. Xerces-C contains a fair amount 
of code whiclj must be custfrmiiced when porting it to 
new plaiforms, but a classic Mac OS port has been 
tlevcdtjped, and a BSD version is in development 
which is likely to compile under Mac OS X. Also of 
note is the gnome-xml parser, which is under active 
development. It falls under the umbrella of the Linux 
Gnome project, but it is independent of the rest of 
Gnome and should be portable to other environments 
and platforms, (For example, it is known to work 
under Windows.) It is also a validating parser, but 
appears to he simpler than Xerces and may be worth a 
look if you need to access a validating parser from C 
and related languages. Ihe gnome-xml w^eb page also 
has links to several other articles to get you started, 
and in particular you should take a look at the article 
on IBM's developerWorks site. 

expat * XML Parser Toolkit 
<http://www.jdark.corn/xml/expaLhtml> 

Objective C wrapper for the expat XML Parser 
<http://softrak.stepwise.com/AppsA/VebObjects/Softra k. woa/1 / 
wa/displayPackage?package=8l 5&os=10> 

The Apache XML Project 
<http://xml.apache.org/> 

IBM^s XML Parser for Java {XML4J) 
<http://www.alphaworks.ibm.com/tech/xml4j> 


IBM's XML for C++ parser (XML4C) 
<http://vyww.alphaworksJbm.com/tech/xml4c> 

The XML library for Gnome 
<http://xml5oft.org/> 

Making application programming easy with 
GNOME libraries, Part 3 

<http://www4Jbm.com/software/developer/[ibrary/gnome3/> 

If yooVc experimenting with XML for tlic first time, 
or you need to proces.s XML in a welvrelated context, 
you should check out the numerous Perl modules 
available. A good place to start is the libxml-perl 
package. Of particular interest are ihe XML-Grove 
modules, which let you manipulate an XML document 
as a tree of objects and access various parts of it using 
a parh-like syntax. This is analogous to tlic DOM and 
XPalh APIs, and the grove interface will likely become 
obsolete after ihese have matured, but in the .short term 
it provides a convenient and powerfJil approach to 
XML processing. There are a number of other APIs 
available for working with XML documents from Perl, 
including DOM-based and SAX-based parser APIs (the 
former allows you to access XML documents as a tree 
of objects, and the latter as a .stream of events), as well 
as support for various appn^aches to XML ciuerying. 
lliM has two excellent articles which are not to be 
missed; one gives a brief run-through of all of the XML- 
related Perl tools available, and the other gives a 
detailed tutorial on manipulating XML using Perl, 
including conversion of XML to HTML and XMl.-drivcn 
database acrccss. 

libxml-perl 

<http://biTsko.slc.ut.us/> 

Essential tools and libraries for using XML with Perl 
<http://www-4.ibm.com/software/developer/library/ 
per[-xml’toolkit/> 

Manipulating XML documents with Perl and 
other scripting languages 

<http://www-4Jbm.com/software/developer/library/xmLperl/> 

When you grow wear>^ of mucking an)und with the innards 
of the ftiture web, cruise on over to the Macfech Online web 
pages al <http://wvvw.rnactech.com/orilirie/>, and lei you browser 
worry about the parsing for a while. B 
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HOW DO YOU SAY 

Superb 




/Vhen you think oi Superb, you think of unusually high quality. Like a superb wine, for example. Majestic. 
?ich. Luxurious. Superior. ■ SuSE Linux is all that. And more. More experience. More adaptability. More 
jpplications—over 1500. ■ More power to you. And more freedom, too. ■ No wonder more than 50,000 
mterprises worldwide bank on its superb open source solutions. Making SuSE the international Linux leader— 
;etting a higher standard for excellence, simplicity and support. ■ Even the price is superb. ■ So, how do you 
^y superb in Linux? SuSE. Ifs a lesson well learned. 

www,suse,com 


Versions for Intel, Alpha, and PowerPC 


The freedom to change. 
The power to change the Linux world. 
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Time matters. 


The fate of the company is in your hands. 

Fvery second ayuiits when youW competing at Inrcmcr speed* 
And the faster your Web application is developed^ deployed and 
miiintaint^d, the faster yotir competition will drop out of sight. 

File solution? Use Pervasive Softwares Tango 2000 to develop 
your ideis with double the speed tTany odter development software, 

* VIsLially develop applicarioas on Mac, and deploy on 
Mac, Windows, I inux and S<^laris 

♦ Advanced XML siipport 

• (xjnnect ditmly to Filemaker or any ODBC database 

• Hxtend applications with JavaBeans 

* High performance Tango server scales with cluster support 


Cjivc yourseif die same coiiipctirivc 
given leading companies like Apple 
and Harbor Frcrght Tools'*1 

Download your Free Tango Demo today! 

Grab rhe time-saving advantages of Tango 2000 absolutely 
FREE Visit our Web site and dnwnlo;»d our FREE fiilly function^ 
Tango 2000 demo. Or call us now to get your demo on CD. 

www.pervasive.comyspeed or 1-800-287-4383 

Hurry! This offer entis soon. 


peiVasive 

VSOFTWARE 
The Freedom tn Create Applications™ 
for Everyone, Everywhere 


TINFWKl ISg 


Apple Computer I. . wdoiwKKH Apph C«ppl«. Inc, meptote onn,» . PKtenart 0fll«flW«.i»„. inc,. MnitprRcIpWTonl. i. . <.«l«nan< M Hurt** Ptnigh, Tnote. 
















